Get billing status

Return the organization plan, renewal date, and whether usage-based billing is enabled.

GET /billing/org

cURL

curl -X GET "https://api.cloud.blnkfinance.com/billing/org" \
  -H "X-blnk-key: CLOUD_API_KEY"

200

{
  "billing_id": "bil_073f7ffe-9dfd-42ce-aa50-d1dca1788adc",
  "billing_email": "[e-mail]",
  "plan": "PRODUCTION_MONTHLY",
  "created_at": "2026-03-02T12:50:33.852747Z",
  "status": "ACTIVE",
  "last_update": "2026-09-09T07:20:10.260935Z",
  "next_renewal": "2026-10-07T12:50:27Z",
  "has_billing_history": true,
  "usage_billing_enabled": true,
  "usage_billing_enabled_at": "2026-09-09T07:20:08.028229Z"
}

Use this to get your organization plan, subscription status, and renewal time.

For payment method, upcoming charge, and the subscription list, use Get billing overview. For allowance and whether one instance is blocked, use Get record counts.

---

Authorization

Blnk Cloud APIs support any one of the following authentication methods. All of them work with your CLOUD_API_KEY or OAUTH_ACCESS_TOKEN.

Pass X-blnk-key: CLOUD_API_KEY or X-blnk-key: OAUTH_ACCESS_TOKEN.

X-blnk-key · string · required

Cloud API key or OAuth access token. Create credentials in API keys or OAuth.

cURL

curl -X GET "https://api.cloud.blnkfinance.com/billing/org" \
  -H "X-blnk-key: CLOUD_API_KEY"

Response

200

{
  "billing_id": "bil_073f7ffe-9dfd-42ce-aa50-d1dca1788adc",
  "billing_email": "[e-mail]",
  "plan": "PRODUCTION_MONTHLY",
  "created_at": "2026-03-02T12:50:33.852747Z",
  "status": "ACTIVE",
  "last_update": "2026-09-09T07:20:10.260935Z",
  "next_renewal": "2026-10-07T12:50:27Z",
  "has_billing_history": true,
  "usage_billing_enabled": true,
  "usage_billing_enabled_at": "2026-09-09T07:20:08.028229Z"
}

billing_id · string

Unique identifier for the organization billing record (bil_...).

billing_email · string

Email on the billing account.

plan · string

Organization plan code, such as PRODUCTION_MONTHLY.

created_at · timestamp

When the organization billing record was created. ISO 8601.

status · string

Organization subscription status, such as ACTIVE.

last_update · timestamp

When the billing record was last updated. ISO 8601.

next_renewal · timestamp

When the current plan renews. ISO 8601. Overview uses a Unix next_billing_date for the next charge.

has_billing_history · boolean

Whether the organization has past invoices or charges.

usage_billing_enabled · boolean

Whether usage-based billing is on for the organization. See Usage-based billing.

usage_billing_enabled_at · timestamp

When usage-based billing was enabled for the organization. ISO 8601.

---

Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool.

To ask questions or discuss issues, please contact us or join our Discord community.