# Account

> Your balance and limits, as the key you're using sees them.

Source: https://docs.nocamclub.com/api/account

```http
GET /v1/account
```

```json
{
  "object": "account",
  "mode": "live",
  "level": "start",
  "credits": { "spendable_on_models": 1250, "bonus": 0 },
  "limits": { "per_minute": 10, "in_progress": 2, "credits_per_day": 2500 },
  "top_up_url": "https://nocamclub.com/account/credits"
}
```

| Field | What it is |
|---|---|
| `mode` | `live` or `test`, from the key |
| `level` | Your account's level. A test key always says `sandbox`. See [Limits](https://docs.nocamclub.com/api/limits.md) |
| `credits.spendable_on_models` | Credits that can buy models through this API. 1 credit = $0.01 |
| `credits.bonus` | Bonus credits. They work for scenes on the site, not for models directly |
| `limits.per_minute` | New generations a minute |
| `limits.in_progress` | Generations in progress at once |
| `limits.credits_per_day` | Credits a day, UTC, or the key's own lower limit if it has one |
| `top_up_url` | Where a person tops up |

Needs the `account:read` permission.

## Before a big job

Check `spendable_on_models` against the price from [`POST /v1/estimate`](https://docs.nocamclub.com/api/models.md#pricing-a-request) first. If it isn't enough, the generation is refused with [`insufficient_credits`](https://docs.nocamclub.com/errors/insufficient_credits.md) and nothing is charged.

An agent should never top up on its own: send the person to `top_up_url`.