Paginated per-respondent vote sets for a campaign.

GET

/brands/me/campaigns/{campaignId}/responses

• Production
• Staging
• Local dev

Requires the analytics scope. Respondents are anonymised via a per-brand HMAC-SHA256 hash of (user|device, id) using the server-side REST_VOTER_ANON_SALT. Raw userId / deviceId values are NEVER returned. Cursor-only pagination; respondents are ordered by their first vote timestamp descending.

Parameters

Path Parameters

campaignId

required

string format: uuid

/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/

Campaign UUID.

Query Parameters

limit

integer

>= 1 <= 100

Page size (1–100, default 20).

cursor

string

Opaque cursor from a previous response.

Responses

200

Paginated responses.

object

data

required

Array<object>

object

respondentId

required

string

>= 1 characters

startedAt

required

string format: date-time

/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$/

completedAt

required

Any of:

string

string format: date-time

/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$/

null

null

totalVotes

required

integer

<= 9007199254740991

votes

required

Array<object>

object

position

required

integer

<= 9007199254740991

slug

required

string

>= 1 characters

option

required

string

Allowed values: A B

votedAt

required

string format: date-time

/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$/

nextCursor

required

Any of:

string

string

null

null

400

Invalid cursor or limit.

401

Missing or invalid bearer token.

403

Bearer token lacks analytics scope or has no brand context.

404

Campaign not found or not owned by the caller.

422

CampaignId is not a UUID.