List Campaign Poll Responses

GET

api

metrics

campaigns

{campaignId}

poll-responses

List Campaign Poll Responses

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

import requests

url = "https://api.sequenzy.com/api/v1/metrics/campaigns/{campaignId}/poll-responses"

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/metrics/campaigns/{campaignId}/poll-responses', 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/metrics/campaigns/{campaignId}/poll-responses",
  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/metrics/campaigns/{campaignId}/poll-responses"

	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/metrics/campaigns/{campaignId}/poll-responses")

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,
  "campaignId": "camp_abc123",
  "blockId": "poll_1",
  "responses": [
    {
      "subscriberId": "sub_123",
      "email": "user@example.com",
      "externalId": null,
      "firstName": "Ana",
      "lastName": null,
      "blockId": "poll_1",
      "variant": "options",
      "question": "Did you get your sample?",
      "attributeKey": "sample_received",
      "allowMultiple": false,
      "answers": ["Yes"],
      "values": ["yes"],
      "respondedAt": "2026-08-08T11:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 100,
    "total": 1,
    "totalPages": 1
  }
}

{ "success": false, "error": "'limit' must be a positive integer" }

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

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

Returns one row per respondent per Poll or NPS block in a campaign, newest answer first, with the answer, its stored value, the subscriber attribute the answer was saved to, and the response time. The campaign metrics endpoint reports the answer distribution; this endpoint reports who answered what and when. Only each subscriber’s latest answer per block is returned, so the counts match the polls summaries. Poll answers are also written to a subscriber attribute, but that attribute carries no response time and holds the latest answer to any email, so respondents for one campaign cannot be reconstructed from it. Also available at GET /api/v1/campaigns/{campaignId}/poll-responses.

Path Parameters

string

required

The ID of the campaign. For a sequence email step, pass the step’s automation node ID.

Query Parameters

string

Restrict results to one poll block. Block IDs come from the polls array of the campaign metrics endpoint.

number

default:"1"

Page number for pagination.

number

default:"100"

Responses per page (max 500).

Common Queries

List everyone who answered a campaign poll

curl "https://api.sequenzy.com/api/v1/metrics/campaigns/camp_abc123/poll-responses?limit=500" \
 -H "Authorization: Bearer YOUR_API_KEY"

Scope to one poll block

curl "https://api.sequenzy.com/api/v1/metrics/campaigns/camp_abc123/poll-responses?blockId=poll_1" \
 -H "Authorization: Bearer YOUR_API_KEY"

Response Fields

Multi-select polls set allowMultiple to true and list every selected option in answers, with the stored values in the parallel values array. email is null when the subscriber has since been deleted.

Responses

{
  "success": true,
  "campaignId": "camp_abc123",
  "blockId": "poll_1",
  "responses": [
    {
      "subscriberId": "sub_123",
      "email": "user@example.com",
      "externalId": null,
      "firstName": "Ana",
      "lastName": null,
      "blockId": "poll_1",
      "variant": "options",
      "question": "Did you get your sample?",
      "attributeKey": "sample_received",
      "allowMultiple": false,
      "answers": ["Yes"],
      "values": ["yes"],
      "respondedAt": "2026-08-08T11:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 100,
    "total": 1,
    "totalPages": 1
  }
}

{ "success": false, "error": "'limit' must be a positive integer" }

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

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

List Campaign Poll Responses

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

import requests

url = "https://api.sequenzy.com/api/v1/metrics/campaigns/{campaignId}/poll-responses"

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/metrics/campaigns/{campaignId}/poll-responses', 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/metrics/campaigns/{campaignId}/poll-responses",
  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/metrics/campaigns/{campaignId}/poll-responses"

	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/metrics/campaigns/{campaignId}/poll-responses")

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,
  "campaignId": "camp_abc123",
  "blockId": "poll_1",
  "responses": [
    {
      "subscriberId": "sub_123",
      "email": "user@example.com",
      "externalId": null,
      "firstName": "Ana",
      "lastName": null,
      "blockId": "poll_1",
      "variant": "options",
      "question": "Did you get your sample?",
      "attributeKey": "sample_received",
      "allowMultiple": false,
      "answers": ["Yes"],
      "values": ["yes"],
      "respondedAt": "2026-08-08T11:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 100,
    "total": 1,
    "totalPages": 1
  }
}

{ "success": false, "error": "'limit' must be a positive integer" }

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

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

​Path Parameters

​Query Parameters

​Common Queries

​List everyone who answered a campaign poll

​Scope to one poll block

​Response Fields

​Responses

Path Parameters

Query Parameters

Common Queries

List everyone who answered a campaign poll

Scope to one poll block

Response Fields

Responses