# List email templates API

> List email templates API reference: GET /templates returns the email templates in your Cresca account, newest first, including drafts, with cursor pagination.

Canonical: https://www.cresca.xyz/docs/api-reference/list-templates
Last updated: 2026-11-05

Use the list email templates API to list the templates in your account, newest first.

GET https://api.cresca.xyz/api/v1/templates

Requires a full-access key. Returns every template you created in Cresca, including ones not yet set up for the API (their `status` is `draft` and `alias` is `null`).

### Query parameters

limit number optional

Number of templates to return, 1 to 100. Default 20. Values outside that range are clamped to it.

after string optional

A template id. Returns templates older than it (the next page). A value that is not a valid id is ignored, and the first page is returned.

## List email templates API example

Request

```bash
curl -X GET 'https://api.cresca.xyz/api/v1/templates?limit=1' \
  -H 'Authorization: Bearer cr_live_xxxxxxxxx'
```

Response 200

```json
{
  "object": "list",
  "has_more": true,
  "data": [
    {
      "object": "template",
      "id": "6713b1f4c2a94e0012ab34cd",
      "name": "Password reset",
      "alias": "password-reset",
      "subject": "Reset your password",
      "from": "Acme <hello@acme.com>",
      "reply_to": null,
      "preview_text": "The link expires in 1 hour.",
      "html": "<p>Hi {{{NAME}}},</p><p><a href=\"{{{RESET_LINK}}}\">Reset your password</a>.</p>",
      "text": null,
      "variables": [
        {
          "key": "NAME",
          "type": "string",
          "fallback_value": "there"
        },
        {
          "key": "RESET_LINK",
          "type": "string",
          "fallback_value": null
        }
      ],
      "status": "published",
      "version": 2,
      "published_at": "2026-10-19T08:30:00.000Z",
      "created_at": "2026-10-18T16:02:11.000Z",
      "updated_at": "2026-10-19T08:30:00.000Z"
    }
  ]
}
```

[Previous Retrieve template](https://www.cresca.xyz/docs/api-reference/retrieve-template) [Next Update template](https://www.cresca.xyz/docs/api-reference/update-template)

Last updated November 5, 2026. Questions? [lalit@cresca.xyz](mailto:lalit@cresca.xyz)
