Get billing usage

Returns credits consumed in the current billing period, the total credit limit, and when the period resets.

Read-only — this endpoint does not consume credits.

See metered prices for current per-search rates.


GET
/billing/usage

Authorization

bearerAuth
AuthorizationBearer <token>

Organization API key from Integrations → API keys.

In: header

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/billing/usage"
{  "requestId": "string",  "creditsUsedThisPeriod": 0,  "creditsLimit": 0,  "billingPeriodEndsAt": "string"}
{  "requestId": "01HXYZABCDEF",  "error": {    "code": "unauthorized",    "message": "Invalid or revoked API key."  }}
{  "requestId": "01HXYZABCDEF",  "error": {    "code": "billing_unavailable",    "message": "Could not load credit balance for this organization. Ensure the workspace has an active subscription."  }}