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

# List templates

> Retrieve a paginated list of your templates.

## Phase

**Phase 1 (Launch)**

## Query parameters

<ParamField query="limit" type="integer" default="25">
  Number of results to return. Range: 1-100.
</ParamField>

<ParamField query="starting_after" type="string">
  Template ID to paginate forward from.
</ParamField>

<ParamField query="ending_before" type="string">
  Template ID to paginate backward from.
</ParamField>

## Response

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "tpl_abc123",
      "object": "template",
      "name": "invoice",
      "description": "Standard customer invoice",
      "version": 3,
      "render_count": 142,
      "created_at": "2026-05-19T10:00:00Z",
      "updated_at": "2026-05-22T14:30:00Z"
    },
    {
      "id": "tpl_def456",
      "object": "template",
      "name": "receipt",
      "description": null,
      "version": 1,
      "render_count": 8,
      "created_at": "2026-05-20T09:00:00Z",
      "updated_at": "2026-05-20T09:00:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}
```

<Note>
  List responses don't include `html`, `css`, `schema`, `defaults`, or `sample_data` to keep payloads small. Use `GET /v1/templates/:id` for the full definition.
</Note>

## Example

```bash theme={null}
curl "https://api.pdfbase.dev/v1/templates?limit=50" \
  -H "Authorization: Bearer pk_live_xxx"
```