Get Campaign

GET

api

campaigns

{campaignId}

Get Campaign

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

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

fetch('https://api.sequenzy.com/api/v1/campaigns/{campaignId}', 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}",
  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}"

	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}")

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,
  "campaign": {
    "id": "camp_abc123",
    "name": "April Launch",
    "subject": "A quick update",
    "emailId": "email_abc123",
    "preheader": "Latest product news",
    "preheaderText": "Latest product news",
    "status": "draft",
    "rejectionComment": null,
    "labels": ["edm", "launch"],
    "blocks": [],
    "emailPreset": "branded",
    "campaignData": null,
    "computedLists": [],
    "targetLists": { "type": "lists", "listIds": ["list_123"] },
    "senderProfileId": "sender_abc123",
    "fromName": "Acme",
    "fromEmail": "hello@example.com",
    "replyProfileId": "reply_abc123",
    "replyToName": "Support",
    "replyToEmail": "support@example.com",
    "scheduledAt": null,
    "sentAt": null,
    "spreadOverHours": null,
    "sendTimeOptimization": false,
    "sendTimeWindowHours": 12,
    "createdAt": "2026-05-01T10:30:00Z",
    "url": "https://sequenzy.com/dashboard/company/comp_abc123/campaign/camp_abc123",
    "previewUrl": "https://sequenzy.com/dashboard/company/comp_abc123/campaign/camp_abc123?step=review"
  }
}

{
  "success": false,
  "error": "Unauthorized"
}

{
  "success": false,
  "error": "Campaign not found"
}

Get a campaign and its editable email blocks. emailId is the campaign’s linked email body - the same record returned by the templates API - so you can correlate a campaign with its entry in List Templates, or pass it as templateId to Create Campaign to reuse the design. It is null for SMS campaigns. emailPreset is that email’s Style > Format: branded (company logo and full footer) or minimal (no logo, simple footer). It is derived from the stored blocks and reported the same way for sequence steps and transactional templates, so you can check that a campaign shares its chrome with the rest of your emails without rendering them. It is null for SMS campaigns and for an email stored as a single raw HTML block, which has no Sequenzy format. status is one of draft, scheduled, waiting_approval, rejected, sending, paused, sent, or cancelled. A campaign in waiting_approval is held for safety review - common on new accounts - and is not sending. rejectionComment carries reviewer feedback once a held campaign is rejected; it stays null while the campaign is still waiting. For native sends, sentAt is stamped after the last recipient is handed off, so for a paced send it is the end of the delivery window rather than when sending started. The pacing itself comes back alongside it: spreadOverHours (null when there is no fixed spread), sendTimeOptimization, and sendTimeWindowHours. When the spread is null, inspect sendTimeOptimization to distinguish an optimal-time send from a campaign with no recorded pacing. Imported campaigns may not carry delivery-strategy metadata from their source provider. For native campaigns, spreadOverHours and sendTimeOptimization mirror what you pass to Schedule Campaign, while sendTimeWindowHours reports the stored optimization window.

Request

string

required

Campaign ID.

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

Responses

{
  "success": true,
  "campaign": {
    "id": "camp_abc123",
    "name": "April Launch",
    "subject": "A quick update",
    "emailId": "email_abc123",
    "preheader": "Latest product news",
    "preheaderText": "Latest product news",
    "status": "draft",
    "rejectionComment": null,
    "labels": ["edm", "launch"],
    "blocks": [],
    "emailPreset": "branded",
    "campaignData": null,
    "computedLists": [],
    "targetLists": { "type": "lists", "listIds": ["list_123"] },
    "senderProfileId": "sender_abc123",
    "fromName": "Acme",
    "fromEmail": "hello@example.com",
    "replyProfileId": "reply_abc123",
    "replyToName": "Support",
    "replyToEmail": "support@example.com",
    "scheduledAt": null,
    "sentAt": null,
    "spreadOverHours": null,
    "sendTimeOptimization": false,
    "sendTimeWindowHours": 12,
    "createdAt": "2026-05-01T10:30:00Z",
    "url": "https://sequenzy.com/dashboard/company/comp_abc123/campaign/camp_abc123",
    "previewUrl": "https://sequenzy.com/dashboard/company/comp_abc123/campaign/camp_abc123?step=review"
  }
}

{
  "success": false,
  "error": "Unauthorized"
}

{
  "success": false,
  "error": "Campaign not found"
}

Get Campaign

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

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

fetch('https://api.sequenzy.com/api/v1/campaigns/{campaignId}', 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}",
  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}"

	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}")

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,
  "campaign": {
    "id": "camp_abc123",
    "name": "April Launch",
    "subject": "A quick update",
    "emailId": "email_abc123",
    "preheader": "Latest product news",
    "preheaderText": "Latest product news",
    "status": "draft",
    "rejectionComment": null,
    "labels": ["edm", "launch"],
    "blocks": [],
    "emailPreset": "branded",
    "campaignData": null,
    "computedLists": [],
    "targetLists": { "type": "lists", "listIds": ["list_123"] },
    "senderProfileId": "sender_abc123",
    "fromName": "Acme",
    "fromEmail": "hello@example.com",
    "replyProfileId": "reply_abc123",
    "replyToName": "Support",
    "replyToEmail": "support@example.com",
    "scheduledAt": null,
    "sentAt": null,
    "spreadOverHours": null,
    "sendTimeOptimization": false,
    "sendTimeWindowHours": 12,
    "createdAt": "2026-05-01T10:30:00Z",
    "url": "https://sequenzy.com/dashboard/company/comp_abc123/campaign/camp_abc123",
    "previewUrl": "https://sequenzy.com/dashboard/company/comp_abc123/campaign/camp_abc123?step=review"
  }
}

{
  "success": false,
  "error": "Unauthorized"
}

{
  "success": false,
  "error": "Campaign not found"
}

Overview

Companies

Sync Rules

Shopify

Websites

Integrations

Sender Profiles

Tracking Settings

Sending Status

Notification Preferences

Subscribers

Tags

Lists

Events

Segments

Audience Syncs

Migrations

Products

Media

Analytics

Sequences

Generation

SMS

Campaigns

Landing Pages

Emails

A/B Tests

Email Sends

Suppressions

Transactional

Templates

Widgets

Commerce

Webhooks

Team

Conversations

Request

Responses

​Request

​Responses

Request

Responses