# Get credit balance

Source: https://checkslip.com/en/docs/get-balance

GET `https://api.checkslip.com/api/billing/balance`

API key

Returns the account's remaining credits, their expiry date, and whether they are running low (low and threshold). The low-credit threshold follows your account's own usage; show it as is; do not compute your own. Needs an API key with credit:read or billing:read.

## Responses

### 200 `application/json`

| Field | Type | Required |
| --- | --- | --- |
| `account_id` | `string (uuid)` | yes |
| `credits` | `integer` | yes |
| `low` | `boolean` | yes |
| `threshold` | `integer` | yes |
| `credits_per_year` | `integer \| null` | yes |
| `expires_at` | `string (date-time) \| null` | yes |
| `updated_at` | `string (date-time)` | yes |
| `last_entry_id` | `string (uuid) \| null` | no |

### Possible errors

401 403 500

An error as Problem Details. All codes are listed at [Error codes](https://checkslip.com/en/docs/errors)

**cURL**

```bash
curl https://api.checkslip.com/api/billing/balance \
  -H "Authorization: Bearer $CHECKSLIP_API_KEY"
```

**Node.js**

```javascript
const res = await fetch("https://api.checkslip.com/api/billing/balance", {
  headers: {
    Authorization: `Bearer ${process.env.CHECKSLIP_API_KEY}`,
  },
});
const data = await res.json();
```

**Python**

```python
import os

import requests

res = requests.get(
    "https://api.checkslip.com/api/billing/balance",
    headers={
        "Authorization": f"Bearer {os.environ['CHECKSLIP_API_KEY']}",
    },
)
data = res.json()
```

```json
{
  "account_id": "0b6c2f5e-8a41-4d1e-9c3a-5f7e2d18a6b4",
  "credits": 1,
  "low": true,
  "threshold": 1,
  "credits_per_year": 1,
  "expires_at": "2026-11-05T09:30:00+07:00",
  "updated_at": "2026-11-05T09:30:00+07:00",
  "last_entry_id": "0b6c2f5e-8a41-4d1e-9c3a-5f7e2d18a6b4"
}
```