---
title: Account & balance
description: "GET /v1/account — balance and usage."
---

Get your account balance in credits and usage statistics.

## Playground

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

`GET /v1/account` returns the account's credit balance and a usage summary for the last 30 days. The endpoint is available to any valid key — no scope required.

<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: 'number', description: 'Current balance in credits' },
    'usage_30d.requests': { type: 'integer', description: 'Number of requests over the last 30 days' },
    'usage_30d.credits_spent': { type: 'number', description: 'Credits spent over the last 30 days' }
  }}
/>

<Callout type="info" title="Credits">
Generations draw credits from the balance of the account the key belongs to. The monetary value of one credit is not exposed via the API — top up your balance in your clipia.ai account. If the balance is too low, `submit` returns `402 insufficient_credits`.
</Callout>