List a brand's public polsts (paginated).

GET

/brands/{brandSlug}/polsts

• Production
• Staging
• Local dev

Filters: isPrivate = false, isDraft = false, archivedAt IS NULL, status ∈ { open, closed } (scheduled polsts hidden). Cursor-only pagination; no offset.

Parameters

Path Parameters

brandSlug

required

Brand slug (DNS-label-safe, ≤63 chars).

string

>= 1 characters <= 63 characters

Brand slug.

Query Parameters

status

string

default: all

Allowed values: open closed all

Filter by polst status (default: all).

order

string

default: recent

Allowed values: recent popular

Sort order (default: recent).

limit

integer

>= 1 <= 100

Page size (1–100, default 20).

cursor

string

Opaque cursor from a previous response.

Responses

200

Paginated polsts.

object

data

required

Array<object>

object

id

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)$/

slug

required

string

>= 1 characters

title

required

string

>= 1 characters

optionA

required

object

label

required

Any of:

string

string

null

null

imageUrl

required

Any of:

string

string

null

null

imageVariants

required

Array<object>

object

url

required

string

width

required

integer

> 0 <= 9007199254740991

optionB

required

object

label

required

Any of:

string

string

null

null

imageUrl

required

Any of:

string

string

null

null

imageVariants

required

Array<object>

object

url

required

string

width

required

integer

> 0 <= 9007199254740991

images

required

object

combined

required

Any of:

string

string

null

null

large

required

Any of:

string

string

null

null

medium

required

Any of:

string

string

null

null

small

required

Any of:

string

string

null

null

social

required

Any of:

string

string

null

null

imageVariants

required

Array<object>

object

url

required

string

width

required

integer

> 0 <= 9007199254740991

placeholder

required

Any of:

string

string

null

null

tallies

required

object

optionA

required

integer

<= 9007199254740991

optionB

required

integer

<= 9007199254740991

total

required

integer

<= 9007199254740991

status

required

string

Allowed values: scheduled open closed

startsAt

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

endsAt

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

brand

required

Any of:

object

object

slug

required

string

>= 1 characters

name

required

string

>= 1 characters

theme

required

object

accent

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

background

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

foreground

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

radius

required

string

Allowed values: NONE SM MD LG FULL

density

required

string

Allowed values: COMPACT COMFORTABLE

fontStack

required

string

Allowed values: SYSTEM SERIF MONO BRAND

fontBrandUrl

required

Any of:

string

string

<= 2048 characters

null

null

logoLightUrl

required

Any of:

string

string

<= 2048 characters

null

null

logoDarkUrl

required

Any of:

string

string

<= 2048 characters

null

null

faviconUrl

required

Any of:

string

string

<= 2048 characters

null

null

hideWatermark

required

boolean

customCss

required

Any of:

string

string

<= 4096 characters

null

null

version

required

integer

<= 9007199254740991

titleColor

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

titleSize

required

Any of:

integer

integer

>= 10 <= 96

null

null

titleWeight

required

Any of:

integer

integer

>= 100 <= 900

null

null

titlePlacement

required

string

Allowed values: ABOVE BELOW HIDDEN

labelColor

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

labelSize

required

Any of:

integer

integer

>= 10 <= 72

null

null

labelPlacement

required

string

Allowed values: HEADER OVERLAID BELOW HIDDEN

labelAlign

required

string

Allowed values: LEFT CENTER

headerFill

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

orBadgeBg

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

orBadgeFg

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

orBadgeDiameter

required

Any of:

integer

integer

>= 24 <= 96

null

null

imageRatio

required

Any of:

number

number

>= 0.25 <= 4

null

null

elevation

required

string

Allowed values: FLAT LIFTED

null

null

createdAt

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)))$/

userVote

required

Any of:

string

string

Allowed values: A B

null

null

nextCursor

required

Any of:

string

string

null

null

400

Invalid cursor or limit.

404

Brand not found.

422

BrandSlug or query params failed validation.