List template versions

GET/v1/templates/{name}/versionsAPI key

A stored template keeps every version it has had. Version 1 is the content from create; each update or restore adds the next number. Nothing is ever removed from the history until the template is deleted.

The list is returned in one response, newest version first, not paginated. Built-in templates have no versions and return 404 template_not_found.

Path parameters

namestringpathrequired

The template name.

Response

dataTemplateVersion[]

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

Show version properties

templateIdstring

The template ID, tmpl_….

versionnumber

The version number, starting at 1.

subjectstring

The subject in this version.

htmlstring

The HTML in this version.

textstring | null

The text body in this version.

variablesVariable[]

The declared variables in this version.

createdAtstring

When this version was saved.

Errors

Status	Code	When
404	`template_not_found`	No stored template with this name.

Request

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

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

const versions = await flaresend.templates.versions('order-shipped');

Response

{
  "data": [
    {
      "templateId": "tmpl_01K6B5A7C9E1G3J5L7N9Q1S3U5",
      "version": 2,
      "subject": "Good news: order {{order.number}} has shipped",
      "html": "<p>Hi {{first_name}}, your order has shipped.</p>",
      "text": null,
      "variables": [{ "name": "first_name", "required": true, "example": "Ada" }],
      "createdAt": "2026-09-28T14:02:00.000Z"
    },
    {
      "templateId": "tmpl_01K6B5A7C9E1G3J5L7N9Q1S3U5",
      "version": 1,
      "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" }],
      "createdAt": "2026-09-26T10:00:00.000Z"
    }
  ]
}

Path parametersCopy Anchor Link

ResponseCopy Anchor Link

ErrorsCopy Anchor Link

Path parameters

Response

Errors