> ## 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. Zero and negative values are returned as stored.                                       |
| `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.

## Errors

| Status | Meaning                                     |
| ------ | ------------------------------------------- |
| 403    | Missing, invalid, or inactive API key       |
| 503    | Account information temporarily unavailable |

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