Skip to main content
GET
List personalization slots

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Headers

X-Test-Mode
enum<string>

Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.

Available options:
true,
false

Query Parameters

slot
string

Return only variants for this slot key (exact match), e.g. hero-banner.

Required string length: 1 - 100
segment_label
string

Return only variants targeted at this segment (champion, high_value_engaged, engaged, new, passive, at_risk, dormant, lost). Unrecognised values are ignored.

Required string length: 1 - 64
cursor
string

Page token — pass meta.pagination.cursor from the previous response to fetch the next page.

Required string length: 1 - 128
limit
integer
default:25

Number of variants per page (1–100).

Required range: 1 <= x <= 100

Response

A page of slot variants in data, plus meta.pagination with the cursor for the next page and has_more (false and a null cursor on the last page).

A page of slot variants in data, plus meta.pagination with the cursor for the next page and has_more (false and a null cursor on the last page).

data
object[]
meta
object