Generations

Get a Generation

GET https://api.getdeckle.dev/v1/generations/:id Retrieve details of a specific PDF generation.

curl https://api.getdeckle.dev/v1/generations/gen_abc123 \
  -H "Authorization: Bearer dk_live_sk_..."

Response

{
  "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

{
  "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
}