Billing

Enable usage billing

Enable usage-based billing for the organization.

POST/billing/usage-billing

Enable usage-based billing for the organization. All instances under that organization are charged once they exceed their included usage. If it is already enabled, Cloud returns the same result. You cannot disable it from this API.

Enterprise authentication

Send these requests to https://api.cloud.blnkfinance.com on Blnk Cloud. On a self-hosted Enterprise deployment, send them to ENTERPRISE_PUBLIC_URL.

Pass an Enterprise API key, or an OAuth access token, in the X-blnk-key header. Create the key in Enterprise API keys, or issue a token with Enterprise OAuth.

This credential comes from the Cloud or Enterprise workspace. A Core API key belongs to the Core instance.

X-blnk-keystringrequiredheader

Enterprise API key, or an OAuth access token.

Response

usage_billing_enabledboolean

Whether usage-based billing is on for the organization.

usage_billing_enabled_attimestamp

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

curl -X POST "https://api.cloud.blnkfinance.com/billing/usage-billing" \
  -H "X-blnk-key: CLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

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