GET/api/v6/account/billing

Billing summary

Mode, currency and available balance or remaining credit for the organization.

Scope

API key with the account capability granted

Usage limit

20 requests per minute

Returns the core billing facts for the organization that owns the API key: mode (prepaid or postpaid), currency, available balance in prepaid or remaining credit in postpaid. The detail — limits, payments and adjustments — lives in /api/v6/account/limits, /api/v6/account/payments and /api/v6/account/adjustments.

The available field is computed exactly like the live spend engine: prepaid balance − consumed; postpaid creditLimit − consumed. All amounts are decimal strings with 6 decimals, in the account currency.

Sensitive financial data

The API key must have the account capability explicitly enabled. Access to all services does NOT grant it: it is granted separately, per key, from the customer portal (Developers → API keys). A key without the capability gets 403.

Responses

200

Billing summary.

{
  "success": true,
  "data": {
    "account": {
      "id": 10000003,
      "displayName": "Acme S.A.S.",
      "currency": "COP",
      "status": "active"
    },
    "billing": {
      "mode": "prepaid",
      "currency": "COP",
      "period": "2026-06",
      "available": "108500.000000",
      "balance": "108500.000000",
      "consumed": "0.000000",
      "reserve": "0.000000",
      "creditLimit": "0.000000"
    }
  },
  "meta": {
    "requestId": "b9b1704baffab21150213c02fd853975",
    "timestamp": "2026-06-02T19:43:59+00:00",
    "responseTimeMs": 6.1
  }
}

401

Invalid or missing credentials.

403

The API key lacks the required capability, or the organization cannot run the request.

429

Request limit exceeded. Wait for Retry-After.

Possible errors

Codes this endpoint can return in error.code. The full detail lives in the catalog.

401AUTH_REQUIREDNo Bearer token was sent, and every call requires one.401AUTH_INVALID_KEYThe API key is not recognized: wrong format, revoked or expired.401AUTH_SERVICE_NOT_ALLOWEDThe key is not allowed to use the service behind this endpoint.403ACCOUNT_NOT_ACTIVEYour organization is suspended or closed.403ACCOUNT_BLOCKEDA full block is active: every call is rejected.403ACCOUNT_CONFIG_NOT_FOUNDWe could not load the organization behind your key.403FORBIDDENGeneric 403: fallback when no `ACCOUNT_*` applies.429RATE_TPS_EXCEEDEDYou exceeded your organization quota for this endpoint.

See the full catalog

Scope and limits

Responses

Possible errors