---
title: Account and balance
description: GET /v1/account — the account's available balance in credits, plus the request count and credits spent by this key over the last 30 days.
icon: Wallet
---

Get the account's available balance in credits and usage statistics for the key.

## Playground

<Callout type="info" title="Use a test key here">
Paste a `clipia_test_…` key into the form below: it charges no credits and calls no models, and the response has the same shape. The form keeps the key in this browser, so never enter a live `clipia_live_…` key here: it is a server-side secret. See [Sandbox](/en/docs/getting-started/sandbox).
</Callout>

<ApiPlayground path="/v1/account" method="get" />

`GET /v1/account` returns the balance of the account the key belongs to and a summary for this key over the last 30 days. Any valid key works — no extra permission is needed.

<Method name="GET" path="/v1/account" />

## Request

<Tabs items={['cURL', 'TypeScript', 'Python']}>
<Tab value="cURL">

```bash
curl https://api.clipia.ai/v1/account \
  -H "Authorization: Bearer $CLIPIA_KEY"
```

</Tab>
<Tab value="TypeScript">

```ts
const account = await clipia.account.get();
console.log(account.balance.credits);
```

</Tab>
<Tab value="Python">

```python
account = client.account.get()
print(account["balance"]["credits"])
```

</Tab>
</Tabs>

**Response `200`**

```json
{
  "account_id": "8f3a1c7e-2b4d-4e6f-9a01-23456789abcd",
  "balance": { "credits": 1840 },
  "usage_30d": { "requests": 512, "credits_spent": 6120 }
}
```

<TypeTable
  type={{
    account_id: { type: 'string', description: 'Account identifier' },
    'balance.credits': { type: 'integer', description: 'Available balance: subscription and purchased credits, minus credits reserved for unfinished jobs' },
    'usage_30d.requests': { type: 'integer', description: 'API requests made with this key in the last 30 days, status polls included' },
    'usage_30d.credits_spent': { type: 'number', description: 'Credits charged to this key in the last 30 days, net of refunds. A test key charges nothing: it shows 0 here, although its requests are counted' }
  }}
/>

<Callout type="info" title="Credits">
Generations and LLM chat draw credits from the balance of the account the key belongs to. You can top up on clipia.ai. If there aren't enough credits, submit returns `402 insufficient_credits`; if the account has no active subscription, `402 subscription_required` — see [Errors](/en/docs/api-reference/errors). The balance in this response does not reflect that restriction.
</Callout>