Waitlist API reference

Waitlist API · Waitlists

get/v1/workspaces/{workspace_id}/waitlistsAuth

List waitlists in this workspace

Newest first, cursor-paginated. Filter by `status`.

Path parameters

workspace_id*string · uuid

Id of the workspace.

Query parameters

limitinteger

Page size, 1 to 100. Defaults to 20.

cursorstring

Opaque cursor from the previous page's `pagination.next_cursor`. Omit for the first page.

statusenum (4)

Only waitlists in this status.

Response · 200 Page of waitlists.

data*array

The waitlists on this page.

pagination*object
next_cursor*string

Cursor for the next page; null on the last page.

has_more*boolean

Whether another page follows.

Example

Request

GET https://api.waitlist.productcraft.co/v1/workspaces/{workspace_id}/waitlists
Authorization: Bearer YOUR_TOKEN

Response

{
  "data": [
    {
      "id": "33a8b309-8753-4f08-90d7-9dc484eff392",
      "workspace_id": "9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b",
      "workspace_slug": "acme",
      "slug": "early-access",
      "display_name": "Early Access Program",
      "description": "string",
      "status": {},
      "accepting_signups": false,
      "signups_note": "This waitlist is a draft, so public sign-ups are refused (422) until you change its status to active.",
      "allowed_origins": [],
      "settings": {},
      "created_by": "string",
      "previous_workspace_slug": "string",
      "created_at": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-01-01T00:00:00.000Z"
    }
  ],
  "pagination": {
    "next_cursor": "string",
    "has_more": false
  }
}