/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/variantsAuthList variants on a waitlist
Cursor-paginated, in (kind, locale, created_at) order. This endpoint used to return a bare JSON array; it returns the standard `{ data, pagination }` envelope.
Path parameters
workspace_id*string · uuidId of the workspace.
waitlist_id*string · uuidId of the waitlist.
Query parameters
limitintegerPage size. Defaults to 20; values above 100 are clamped to 100.
cursorstringOpaque cursor from the previous page's `pagination.next_cursor`. Omit for the first page.
Response · 200 Page of variants in (kind, locale, created_at) order with a pagination cursor.
data*arrayThe variants on this page.
pagination*objectnext_cursor*stringOpaque cursor for the next page. `null` when no more pages are available.
Example: "eyJwb3NpdGlvbiI6MjB9"
has_more*booleanTrue iff another page exists; if true, pass `next_cursor` on the next request.
Example: false
Example
Request
GET https://api.waitlist.productcraft.co/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/variants
Authorization: Bearer YOUR_TOKENimport { Waitlist } from "@productcraft/waitlist";
// Reads PRODUCTCRAFT_API_KEY from the environment
const waitlist = new Waitlist();
for await (const variant of waitlist.lists.variants.list("3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f")) {
console.log(variant);
}
const page = await waitlist.lists.variants.list("3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f", {}, { timeout: 5_000 });waitlist.lists.variants.list(waitlistId, params?, options?): PagePromise<Waitlist.Variant>
Response
{
"data": [
{
"id": "00000000-0000-0000-0000-000000000000",
"waitlist_id": "00000000-0000-0000-0000-000000000000",
"kind": {},
"locale": "string",
"copy": {
"display_name": "Accès anticipé"
},
"weight": 0,
"active": false,
"created_at": "2026-01-01T00:00:00.000Z"
}
],
"pagination": {
"next_cursor": "eyJwb3NpdGlvbiI6MjB9",
"has_more": false
}
}