List templates

List the templates in your account, newest first.

GEThttps://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

limitnumberoptional

Number of templates to return, 1 to 100. Default 20.

afterstringoptional

A template id. Returns templates older than it (the next page).

Example

Request

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

Response 200

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