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

# GET /v1/generations

> Retrieve generation history and details.

# Generations

## Get a Generation

`GET https://api.getdeckle.dev/v1/generations/:id`

Retrieve details of a specific PDF generation.

```bash theme={null}
curl https://api.getdeckle.dev/v1/generations/gen_abc123 \
  -H "Authorization: Bearer dk_live_sk_..."
```

### Response

```json theme={null}
{
  "id": "gen_abc123",
  "template_id": null,
  "input_type": "html",
  "status": "completed",
  "url": "https://cdn.getdeckle.dev/gen_abc123.pdf",
  "pages": 2,
  "file_size": 45230,
  "generation_time_ms": 1840,
  "error": null,
  "created_at": "2026-02-24T12:00:00.000Z"
}
```

## List Generations

`GET https://api.getdeckle.dev/v1/generations`

List all generations for the authenticated user.

### Query Parameters

| Parameter | Type    | Default | Description         |
| --------- | ------- | ------- | ------------------- |
| `limit`   | integer | 50      | Max results (1-100) |
| `offset`  | integer | 0       | Pagination offset   |

### Response

```json theme={null}
{
  "data": [
    {
      "id": "gen_abc123",
      "template_id": null,
      "input_type": "html",
      "status": "completed",
      "url": "https://cdn.getdeckle.dev/gen_abc123.pdf",
      "pages": 2,
      "file_size": 45230,
      "generation_time_ms": 1840,
      "created_at": "2026-02-24T12:00:00.000Z"
    }
  ],
  "has_more": false
}
```