> ## 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.

# Usage History

> Retrieve a paginated log of your API usage and charges.

<Note>
  This page covers the usage history endpoint. For account balance, see [Get Account](/api-reference/account/get).
</Note>

## Query Parameters

<ParamField query="model" type="string">
  Filter by model slug (e.g. `veo-3.1-fast`, `gpt-4o-image`).
</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>

## Response `200 OK`

Returns a paginated list of usage records.

<ResponseField name="data" type="array">
  <Expandable title="Usage record">
    <ResponseField name="id" type="integer">Internal usage record ID.</ResponseField>
    <ResponseField name="model_key" type="string">Internal model key (not the API slug).</ResponseField>
    <ResponseField name="generation_type" type="string">`video` | `image`</ResponseField>
    <ResponseField name="amount_usd" type="number">Amount charged in USD.</ResponseField>
    <ResponseField name="source" type="string">`api` | `web`</ResponseField>
    <ResponseField name="created_at" type="string">ISO 8601 timestamp.</ResponseField>
  </Expandable>
</ResponseField>

## Example

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