List Campaign Variations

GET

api

campaigns

{campaignId}

variations

List Campaign Variations

curl --request GET \
  --url https://api.sequenzy.com/api/v1/campaigns/{campaignId}/variations \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.sequenzy.com/api/v1/campaigns/{campaignId}/variations"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/campaigns/{campaignId}/variations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/campaigns/{campaignId}/variations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/campaigns/{campaignId}/variations"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/campaigns/{campaignId}/variations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "variations": [
    {
      "id": "var_9xk2",
      "emailId": "email_abc123",
      "parentId": null,
      "label": "V2",
      "name": "Warm and personal",
      "summary": "Rewrote the opening in a friendlier voice and shortened the body.",
      "prompt": "Three warmer, shorter versions",
      "style": "fresh",
      "status": "ready",
      "error": null,
      "subject": "A quick note about our pricing",
      "previewText": null,
      "blocks": [
        { "id": "h1", "type": "heading", "content": "A quick note about pricing", "level": 1 }
      ],
      "emailTheme": null,
      "fontFamily": null,
      "position": null,
      "inUse": false,
      "usedAt": null,
      "createdAt": "2026-10-14T09:12:00.000Z",
      "updatedAt": "2026-10-14T09:12:41.000Z"
    }
  ]
}

{
  "error": "This is an SMS campaign. SMS campaigns are managed from the dashboard; this endpoint only supports email campaigns."
}

{
  "error": "Invalid API key"
}

{
  "error": "Campaign not found"
}

Variations are alternative versions of a campaign’s email that you compare side by side on the editor’s Canvas tab. The campaign keeps sending its email until you use a variation. This lists the campaign’s variations, oldest first. Discarded variations are not listed. While a variation is generating, poll this endpoint (or Get Variation) until its status is ready or failed.

Request

string

required

Campaign ID. Email campaigns only.

curl "https://api.sequenzy.com/api/v1/campaigns/camp_abc123/variations" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

array

The variations, oldest first.

The variation object

string

Variation ID.

string

Canvas label: V1, V2, … for versions of the email, V2.1, V2.2, … for branches of V2. Labels are never reused, even after a discard.

string

Short name, such as the direction it was generated in.

string | null

What changed, in a sentence.

string | null

The request that generated it. null for variations you saved yourself.

string

generating, ready or failed. A variation still generating after 10 minutes is reported as failed.

string | null

Why generation failed.

string | null

The nearest variation it descends from that has not been discarded. null when it was derived from the email.

string | null

The subject this variation uses. null keeps the email’s subject.

string | null

The preview text this variation uses. null keeps the email’s.

string | null

How far it was asked to move from its source (close, fresh or bold) when AI generated it.

array | null

The variation’s email blocks. null while generating or after a failure.

object | null

The variation’s own email theme. null means it uses the email’s theme.

string | null

The variation’s own body font stack. null means it uses the email’s font.

object | null

Where the user placed it on the editor canvas, as { "x", "y" } in canvas pixels. null means the canvas places it automatically.

boolean

Whether using this variation would leave the campaign email unchanged: the same blocks, and its own subject, preview text, theme and font when it has them. When several variations match, only the one used most recently is in use.

string | null

When this variation was last put in the campaign email, as an ISO 8601 timestamp.

string

ISO 8601 timestamp.

string

ISO 8601 timestamp.

{
  "success": true,
  "variations": [
    {
      "id": "var_9xk2",
      "emailId": "email_abc123",
      "parentId": null,
      "label": "V2",
      "name": "Warm and personal",
      "summary": "Rewrote the opening in a friendlier voice and shortened the body.",
      "prompt": "Three warmer, shorter versions",
      "style": "fresh",
      "status": "ready",
      "error": null,
      "subject": "A quick note about our pricing",
      "previewText": null,
      "blocks": [
        { "id": "h1", "type": "heading", "content": "A quick note about pricing", "level": 1 }
      ],
      "emailTheme": null,
      "fontFamily": null,
      "position": null,
      "inUse": false,
      "usedAt": null,
      "createdAt": "2026-10-14T09:12:00.000Z",
      "updatedAt": "2026-10-14T09:12:41.000Z"
    }
  ]
}

{
  "error": "This is an SMS campaign. SMS campaigns are managed from the dashboard; this endpoint only supports email campaigns."
}

{
  "error": "Invalid API key"
}

{
  "error": "Campaign not found"
}

List Campaign Variations

curl --request GET \
  --url https://api.sequenzy.com/api/v1/campaigns/{campaignId}/variations \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.sequenzy.com/api/v1/campaigns/{campaignId}/variations"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/campaigns/{campaignId}/variations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/campaigns/{campaignId}/variations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/campaigns/{campaignId}/variations"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/campaigns/{campaignId}/variations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "variations": [
    {
      "id": "var_9xk2",
      "emailId": "email_abc123",
      "parentId": null,
      "label": "V2",
      "name": "Warm and personal",
      "summary": "Rewrote the opening in a friendlier voice and shortened the body.",
      "prompt": "Three warmer, shorter versions",
      "style": "fresh",
      "status": "ready",
      "error": null,
      "subject": "A quick note about our pricing",
      "previewText": null,
      "blocks": [
        { "id": "h1", "type": "heading", "content": "A quick note about pricing", "level": 1 }
      ],
      "emailTheme": null,
      "fontFamily": null,
      "position": null,
      "inUse": false,
      "usedAt": null,
      "createdAt": "2026-10-14T09:12:00.000Z",
      "updatedAt": "2026-10-14T09:12:41.000Z"
    }
  ]
}

{
  "error": "This is an SMS campaign. SMS campaigns are managed from the dashboard; this endpoint only supports email campaigns."
}

{
  "error": "Invalid API key"
}

{
  "error": "Campaign not found"
}

​Request

​Response

​The variation object

Request

Response

The variation object