Get usage billing

Check whether usage-based billing is enabled for the organization.

GET /billing/usage-billing

cURL

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

200

{
  "usage_billing_enabled": true,
  "usage_billing_enabled_at": "2026-09-09T07:20:08.028229Z"
}

Check whether usage-based billing is enabled for the organization. When it is, all instances under that organization are charged once they exceed their included usage.

To see usage for one instance, use Get record counts. To enable it, use Enable usage billing.

---

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/usage-billing" \
  -H "X-blnk-key: CLOUD_API_KEY"

Response

200

{
  "usage_billing_enabled": true,
  "usage_billing_enabled_at": "2026-09-09T07:20:08.028229Z"
}

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.