Waitlist API reference

Waitlist API · Entries

get/v1/workspaces/{workspace_id}/waitlists/{waitlist_id}/entriesAuth

List entries on a waitlist

Queue-position order, cursor-paginated. Filterable by status, free-text search across email/name, a `created_at` window and `is_test`.

Path parameters

workspace_id*string · uuid

Id of the workspace.

waitlist_id*string · uuid

Id of the waitlist.

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 (3)

Only entries in this status.

searchstring

Case-insensitive substring match across the entry `email` OR `name`. Trimmed; blank means no filter. Composes (AND) with `status`, `since` and `until`.

sincestring · date-time

ISO-8601 inclusive lower bound on `created_at`. Malformed values are rejected with a 400.

untilstring · date-time

ISO-8601 exclusive upper bound on `created_at`. Must be after `since`. Malformed values are rejected with a 400.

is_testboolean

`true` lists only test entries ("Add test signup"), `false` only real ones. Omitted lists both; test entries come first (negative positions).

Response · 200 Page of entries with pagination cursor.

data*array

The entries 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/{waitlist_id}/entries
Authorization: Bearer YOUR_TOKEN

Response

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "waitlist_id": "00000000-0000-0000-0000-000000000000",
      "workspace_id": "00000000-0000-0000-0000-000000000000",
      "email": "user@example.com",
      "name": "string",
      "interest": "string",
      "referrer": "string",
      "referral_code": "string",
      "referral_count": 0,
      "referred_by_entry_id": "00000000-0000-0000-0000-000000000000",
      "position": 0,
      "is_test": false,
      "status": {},
      "invited_at": "2026-01-01T00:00:00.000Z",
      "invited_to_app_slug": "string",
      "metadata": {},
      "created_at": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-01-01T00:00:00.000Z"
    }
  ],
  "pagination": {
    "next_cursor": "string",
    "has_more": false
  }
}