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.

Authorization

bearerAuth

AuthorizationBearer <token>

Organization API key from Integrations → API keys.

In: header

Response Body

`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": "rate_limited",    "message": "Rate limit exceeded for linkedin. Try again later.",    "retryAfter": 42  }}

{  "requestId": "01HXYZABCDEF",  "error": {    "code": "billing_unavailable",    "message": "Could not load credit balance for this organization. Ensure the workspace has an active subscription."  }}

Authorization

Response Body

200application/json

401application/json

429application/json

502application/json

`application/json`

`application/json`

`application/json`

`application/json`