List templates

The project's stored templates, followed by the built-in templates they don't replace.

GET/v1/templatesAPI key

Returns every template you can send with in one response, not paginated:

Templates stored in the project (source: "db"), sorted by name.
Then the built-in templates (source: "git"), except those a stored template with the same name replaces.

Built-in templates are read-only. In this list they have id: null, version: null, an empty subject and html: null. Retrieve one by name to see it rendered with example data.

Response

dataTemplate[]

The templates. The Node.js client returns this array directly.

Show template properties

idstring | null

tmpl_… for stored templates, null for built-in ones.

source'db' | 'git'

db for stored templates, git for built-in ones.

projectIdstring | null

null for built-in templates.

namestring

The name to pass as template when sending.

subjectstring

The subject, unrendered. Empty for built-in templates in this list.

htmlstring | null

The HTML, unrendered. null for built-in templates in this list.

textstring | null

The text body, or null.

variablesVariable[]

{ name, required, example } for each variable. For built-in templates, one entry per top-level data field, with required: false and the value from the template's example data.

versionnumber | null

The current version. null for built-in templates.

createdAtstring | null

null for built-in templates.

updatedAtstring | null

null for built-in templates.

Request

import { Flaresend } from '@flaresend/client';

const flaresend = new Flaresend({
  apiKey: process.env.FLARESEND_API_KEY!,
  baseUrl: 'https://mailer.example.com',
});

const templates = await flaresend.templates.list();

Response

{
  "data": [
    {
      "id": "tmpl_01K6B5A7C9E1G3J5L7N9Q1S3U5",
      "source": "db",
      "projectId": "proj_01K6A9W2E4R6T8Y0U2I4O6P8A0",
      "name": "order-shipped",
      "subject": "Order {{order.number}} is on its way",
      "html": "<p>Hi {{first_name}}, your order has shipped.</p>",
      "text": null,
      "variables": [
        { "name": "first_name", "required": true, "example": "Ada" }
      ],
      "version": 3,
      "createdAt": "2026-09-26T10:00:00.000Z",
      "updatedAt": "2026-09-27T09:12:00.000Z"
    },
    {
      "id": null,
      "source": "git",
      "projectId": null,
      "name": "magic-link",
      "subject": "",
      "html": null,
      "text": null,
      "variables": [
        { "name": "loginUrl", "required": false, "example": "https://app.example.com/auth/magic?token=abc123" },
        { "name": "expiresInMinutes", "required": false, "example": 15 }
      ],
      "version": null,
      "createdAt": null,
      "updatedAt": null
    }
  ]
}

ResponseCopy Anchor Link

Response