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

# Get Account

> Retrieve your account balance, spending, and usage history.

## Account Info

### `GET /account`

Returns your current balance and spend totals.

#### Response `200 OK`

<ResponseField name="data" type="object">
  <Expandable title="Account object" defaultOpen>
    <ResponseField name="name" type="string">
      Your display name.
    </ResponseField>

    <ResponseField name="email" type="string">
      Your account email.
    </ResponseField>

    <ResponseField name="usd_balance" type="number">
      Current USD balance available for generations. 4 decimal places.
    </ResponseField>

    <ResponseField name="usd_spent" type="number">
      Total USD spent across all generations. 4 decimal places.
    </ResponseField>
  </Expandable>
</ResponseField>

#### Example

```bash theme={null}
curl https://veogen.studio/api/v1/account \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"
```

```json theme={null}
{
    "data": {
        "name": "Alex Chen",
        "email": "alex@example.com",
        "usd_balance": 4.25,
        "usd_spent": 3.78
    }
}
```

***

## Usage History

### `GET /account/usage`

Returns a paginated log of API charges.

#### Query Parameters

<ParamField query="model" type="string">
  Filter by model slug (e.g. `veo-3.1-fast`).
</ParamField>

<ParamField query="type" type="string">
  Filter by generation type: `video` or `image`.
</ParamField>

<ParamField query="per_page" type="integer">
  Results per page. Defaults to `25`.
</ParamField>

#### Example

```bash theme={null}
curl "https://veogen.studio/api/v1/account/usage?type=video&per_page=5" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"
```

```json theme={null}
{
    "current_page": 1,
    "data": [
        {
            "id": 1042,
            "model_key": "veo_3_1_fast",
            "generation_type": "video",
            "amount_usd": 0.3,
            "source": "api",
            "created_at": "2025-01-15T10:31:15.000000Z"
        },
        {
            "id": 1041,
            "model_key": "gpt4o_image",
            "generation_type": "image",
            "amount_usd": 0.02,
            "source": "api",
            "created_at": "2025-01-15T10:28:00.000000Z"
        }
    ],
    "per_page": 5,
    "total": 28
}
```

<Note>
  Top up your balance at
  [veogen.studio/billing](https://veogen.studio/billing). Funds are added
  instantly and never expire.
</Note>