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

# List Generations

> Retrieve a paginated list of your past generations.

## Query Parameters

<ParamField query="type" type="string">
  Filter by generation type. One of: `video`, `image`.

  If omitted, returns a combined list of both, sorted by most recent.
</ParamField>

<ParamField query="per_page" type="integer">
  Number of results per page. Defaults to `20`, maximum `100`.
</ParamField>

<ParamField query="page" type="integer">
  Page number. Only applicable when `type` is specified. Defaults to `1`.
</ParamField>

***

## Response `200 OK`

<ResponseField name="data" type="array">
  Array of [generation objects](/api-reference/generations/get).
</ResponseField>

<ResponseField name="meta" type="object">
  Pagination metadata. Only present when `type` filter is used.

  ```json theme={null}
  {
    "current_page": 1,
    "last_page": 5,
    "per_page": 20,
    "total": 98
  }
  ```
</ResponseField>

***

## Example

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

```bash List only videos (paginated) theme={null}
curl "https://veogen.studio/api/v1/generations?type=video&per_page=10&page=1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"
```

**Response:**

```json theme={null}
{
  "data": [
    {
      "id": "01928abc-def0-7123-b456-789012345678",
      "status": "completed",
      "model": "veo-3.1-fast",
      "type": "video",
      "prompt": "Ocean waves crashing on a rocky shore",
      "parameters": {
        "aspect_ratio": "16:9",
        "resolution": "1080p"
      },
      "output": {
        "url": "https://veogen.studio/storage/videos/01928abc.mp4",
        "download_url": "https://veogen.studio/storage/videos/01928abc.mp4?download=1",
        "content_type": "video/mp4"
      },
      "error": null,
      "created_at": "2025-01-15T10:30:00+00:00",
      "completed_at": "2025-01-15T10:31:15+00:00"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 3,
    "per_page": 10,
    "total": 24
  }
}
```