Docs /Getting Started//credits

/credits

Read your live credit balance through the API.

`/credits`

Organizations on request pricing (the Developer plan) pay for API usage from a prepaid credit balance. This endpoint lets you read that balance programmatically, so you can monitor spend and alert on a low balance without opening the billing page. See Developer Plan and Credits for how credits work.

Authentication

The /credits/balance endpoint requires your API key in the Authorization: Bearer header. The key must belong to an organization Admin: this route checks the manage_billing permission, and a key created by an Editor, Developer, or Viewer member receives a 403 with code organization_permission_denied. The figures returned are for the organization the key belongs to.

All amounts are strings. Fields ending in _nano_usd are integers in billionths of a US dollar and are exact, so use them for arithmetic. Fields ending in _usd are the same values as decimal strings for display.

`/credits/balance`

HTTP request

GET https://api.featherless.ai/credits/balance

curl https://api.featherless.ai/credits/balance \
  -H "Authorization: Bearer $FEATHERLESS_API_KEY"

Response body

{
  "balance_nano_usd": "42500000000",
  "balance_usd": "42.500000000",
  "reserved_nano_usd": "12000000",
  "reserved_usd": "0.012000000",
  "available_nano_usd": "42488000000",
  "available_usd": "42.488000000",
  "currency": "usd"
}

balance is the credit currently on your account.
reserved is credit held for requests that are still in flight. A reservation is released when the request finishes and replaced by the actual debit.
available is balance minus reserved. This is the figure that decides whether new requests are accepted, so it is the one to monitor and alert on.

Request usage is settled in five-minute windows, so available_usd can trail live traffic by a few minutes. Polling this endpoint once a minute is fine.

Last edited: Sep 9, 2026