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

# Check balance

> Read the authenticated API key owner's Agent API credits without starting work.

# Check balance

`GET /v1/balance` returns the balance owned by the supplied API key. It accepts no user or account selector, calls no image service, and costs nothing.

```bash theme={null}
curl https://api.dreamlayer.io/v1/balance \
  -H "Authorization: Bearer $DREAMLAYER_API_KEY"
```

```json theme={null}
{
  "promotional": 0,
  "purchased": 58,
  "available": 58,
  "credit_usd": "0.17"
}
```

The snapshot is serialized with credit reservation, settlement, and restoration. Balances cannot be negative. Responses use `Cache-Control: private, no-store`, `Pragma: no-cache`, and `Vary: Authorization`, so shared caches must not retain one account's balance.

Use `available` to decide whether to start a one-credit image request. Other account, rate, spend, or concurrency limits can still refuse a submit. Handle the documented [error contract](/agent-api/errors) on every request.