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

# Top-up Info

> Plan eligibility, top-up presets, credit balance and auto top-up status for the workspace

Returns whether the workspace can buy credit top-ups, the plan rate, the preset amounts and the current credit balance. Use it to render a top-up screen before calling [`POST /billing/add-funds`](https://docs.60db.ai/api-reference/billing/add-funds).

> [!NOTE]
>
> Only the **workspace owner** can call this endpoint. It is protected by the `billing:manage` permission.

## Request

### Headers

**Authorization** `string` *required*

Bearer token (JWT or API key)

## Response

**data.eligible** `boolean`

`true` when the plan is `creator` or `pro` with status `active` or `trialing`

**data.plan\_slug** `string`

Current plan slug, for example `free`, `starter`, `creator` or `pro`

**data.eligible\_plans** `array`

Plan slugs that can buy top-ups: `["creator", "pro"]`

**data.rate\_credits\_per\_usd** `number | null`

Credits per \$1 at the current plan rate. `null` when not eligible.

**data.limits** `object`

`min_usd` (10), `max_usd` (1000) and `presets_usd` (`[10, 25, 50, 100]`)

**data.presets** `array`

Each item has `usd` and `credits`. Empty when not eligible.

**data.balance** `object`

`plan_credits` (renewing monthly), `topup_credits` (never expire) and `total_credits`

**data.auto\_topup** `object | null`

Always `null` for now. Automatic top-up is coming soon.

```bash cURL theme={null}
curl "https://api.60db.ai/billing/topup" \
  -H "Authorization: Bearer your-api-key"
```

```json Response (Creator) theme={null}
{
  "success": true,
  "data": {
    "eligible": true,
    "plan_slug": "creator",
    "eligible_plans": ["creator", "pro"],
    "rate_credits_per_usd": 18181.818,
    "limits": { "min_usd": 10, "max_usd": 1000, "presets_usd": [10, 25, 50, 100] },
    "presets": [
      { "usd": 10, "credits": 181818 },
      { "usd": 25, "credits": 454545 },
      { "usd": 50, "credits": 909090 },
      { "usd": 100, "credits": 1818181 }
    ],
    "balance": { "plan_credits": 12000, "topup_credits": 500000, "total_credits": 512000 },
    "auto_topup": null
  }
}
```

## Errors

| Status | Meaning |
| - | - |
| 400 | Workspace not resolved |
| 403 | Caller is not the workspace billing owner |

See [Plans, Credits & Top-ups](https://docs.60db.ai/get-started/plans-credits-and-top-ups.md) for the rate formula and plan rules.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.