List template versions | Nexiom Connect

GET/v1/emails/templates/{templateId}/versions

Authorization

Bearer token

Authorizationrequiredheader: Send your API key as Bearer YOUR_API_KEY.
Permissionemail.full_access

Path parameters

templateIdrequiredstring: The template ID.

Query parameters

limitoptionalinteger: Versions per response, from 1 to 100; default 50.
beforeVersionoptionalinteger: Return only versions numbered below this one. Pass the last version_number of the previous response to read older versions.

Versions are returned newest first. Continue with beforeVersion until a response has fewer than limit versions.

Response

application/json200 OK

Each version has the same fields as published_version in Retrieve a template. status is draft for the version being edited, published for the version sends use, and saved for earlier versions.

curl "https://api-connect.nxiom.com/api/v1/emails/templates/YOUR_TEMPLATE_ID/versions?limit=50" \
  -H "Authorization: Bearer $NEXIOM_API_KEY"

Set NEXIOM_API_KEY in your environment.

{
  "message": "Email template versions fetched",
  "data": [
    {
      "id": "version_example",
      "template_id": "template_example",
      "version_number": 2,
      "status": "published",
      "subject": "Welcome, {{first_name}}",
      "preview_text": null,
      "from_name": null,
      "from_address": null,
      "reply_to": null,
      "content": {},
      "html": "<p>Hi {{first_name}}</p>",
      "text": "Hi {{first_name}}",
      "thumbnail_url": null,
      "editor_revision": 4,
      "created_by_customer_id": null,
      "published_by_customer_id": null,
      "published_at": "2026-09-21T09:00:00.000Z",
      "created_at": "2026-09-21T08:00:00.000Z",
      "updated_at": "2026-09-21T09:00:00.000Z",
      "variables": [
        {
          "id": "variable_example",
          "key": "first_name",
          "type": "string",
          "required": true,
          "fallback_value": null
        }
      ]
    }
  ]
}

Example successful response.

Authorization#

Path parameters#

Query parameters#

Response#

Authorization

Path parameters

Query parameters

Response