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

# Account And Credits

> Check plan access, remaining credits, usage, rate limits, and voice quota.

Use account endpoints before creating expensive jobs so your integration can decide whether to continue, queue later, or ask a user to top up.

## Endpoints

| Method | Endpoint              | Purpose                                                      |
| ------ | --------------------- | ------------------------------------------------------------ |
| `GET`  | `/v1/account/credits` | Get the remaining AI credit balance and voice quota.         |
| `GET`  | `/v1/account/usage`   | Get credits, API usage, rate-limit tier, and usage counters. |
| `GET`  | `/v1/account/plan`    | Get the current plan and API eligibility.                    |

## Credits Response

```json theme={"theme":"github-dark"}
{
  "object": "account_credits",
  "plan": "creator",
  "api_enabled": true,
  "credits": {
    "total_credits": 420
  },
  "voice_quota": {
    "remaining": 3,
    "limit": 3,
    "simultaneous_limit": 3
  },
  "updated_at": "2026-05-17T12:00:00Z"
}
```

## Usage Response

```json theme={"theme":"github-dark"}
{
  "object": "account_usage",
  "plan": "creator",
  "api_enabled": true,
  "credits": {
    "total_credits": 420
  },
  "rate_limits": {
    "tier": "standard",
    "requests_per_minute": 60,
    "active_jobs": 3
  },
  "usage": {
    "requests_this_cycle": 238,
    "credits_reserved_this_cycle": 820,
    "credits_refunded_this_cycle": 45,
    "jobs_completed_this_cycle": 31,
    "jobs_failed_this_cycle": 2
  }
}
```

## Possible Errors

| HTTP | Code            | When it happens                                                    |
| ---: | --------------- | ------------------------------------------------------------------ |
|  401 | `unauthorized`  | API key is missing, invalid, expired, or revoked.                  |
|  403 | `plan_required` | API access requires Creator or higher.                             |
|  403 | `billing_issue` | Paid access is paused, expired, disputed, or otherwise not usable. |
|  429 | `rate_limited`  | Key, account, or IP exceeded rate limits.                          |