# Credits API

> Check remaining XBeast credits for the current billing month.

Source: https://xbeast.io/docs/api-credits

Returns the same monthly credit totals shown on the XBeast dashboard. Credits reset at the start of each billing cycle (the 1st of the month for users without a subscription). Publishing a post to X costs 1 credit (plus 8 if it contains a URL), charged after a successful send.

**`GET /api/v1/credits`**

```json
{
  "credits_used": 120,
  "credits_available": 880,
  "credits_limit": 1000,
  "resets_at": "2026-10-15T00:00:00.000Z"
}
```

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| credits_used | number | — | Credits consumed this billing cycle. |
| credits_available | number | — | Remaining credits (limit minus used, never below 0). |
| credits_limit | number | — | Plan monthly allowance. |
| resets_at | string (ISO 8601) | — | Start of the next billing cycle, when usage counters reset. |

**curl**

```bash
curl "https://xbeast.io/api/v1/credits" \
  -H "Authorization: Bearer xb_live_YOUR_KEY"
```