Allowance

How much AI capacity is left this week

Returns a coarse state and a renewal date — deliberately never a balance, a count, or a percentage. AI actions (chat, enrichment runs, briefs, contact finds) draw against a weekly allowance on the free tier; enterprise and internal are unmetered and report `metered: false`. Clients should show nothing while `comfortable`, a quiet notice at `low`, and the upgrade path at `exhausted`. Requests refused for want of allowance return 402 from the acting endpoint, not from here.

GET
/allowance

Returns a coarse state and a renewal date — deliberately never a balance, a count, or a percentage. AI actions (chat, enrichment runs, briefs, contact finds) draw against a weekly allowance on the free tier; enterprise and internal are unmetered and report metered: false. Clients should show nothing while comfortable, a quiet notice at low, and the upgrade path at exhausted. Requests refused for want of allowance return 402 from the acting endpoint, not from here.

AuthorizationBearer <token>

API key (sk_live_... prefix). Generate keys in the UI under Settings > API Keys, then send it as Authorization: Bearer sk_live_...

In: header

Response Body

application/json

application/json

application/json

curl -X GET "https://loading/api/v1/allowance"
{
  "data": {
    "state": "comfortable",
    "renews_at": "2019-08-24T14:15:22Z",
    "metered": true
  }
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}