> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sentrion.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Credit Balance

> Read your current credit balance and billing information

Read the current balance for the authenticated API key. No query parameters
or target API key are needed.

## Authentication and credits

Use `Authorization: Bearer YOUR_API_KEY`. An active API key is required. This
endpoint consumes no credits and works with zero or negative balances.

## Example request

```bash theme={null}
curl 'https://api.sentrion.ai/api/v1/credits/balance' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

## Response

```json theme={null}
{
  "credits_remaining": 150,
  "plan_type": "basic",
  "billing_date": "2026-09-15"
}
```

| Field | Meaning |
| - | - |
| `credits_remaining` | Current combined credit balance, excluding expired unused credits. May be zero or negative. |
| `plan_type` | Stored plan name, or null when unset. It does not define a credit allowance. |
| `billing_date` | Billing-cycle anchor for duplicate-charge protection, or null when unset. It is not an expiry or promised renewal date. |

The response uses `Cache-Control: no-store` so callers receive a fresh balance.
Separate remaining plan/top-up balances and expiry dates are not provided and
cannot be derived from the total or billing date.

See [Credit Policy](https://docs.sentrion.ai/api-reference/credit-policy.md) for rollover and expiry rules.

## Errors

| Status | Meaning |
| - | - |
| 403 | Missing, invalid, or inactive API key |
| 503 | Account information temporarily unavailable |
| 500 | Unexpected server error; response body is plain text |

JSON errors use a `detail` field. Successful responses use the object shown above,
without a `success` or `data` wrapper.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.