Waitlist API reference

Waitlist API · Public-Waitlist

get/v1/waitlists/{workspace_slug}/{waitlist_slug}/leaderboard

Public top-50 referral leaderboard. Emails are masked. Anonymous read; same access policy as the public waitlist info endpoint.

Deprecated: use `GET …/leaderboard/top`, which returns the same rows in a `{ data }` envelope. This route keeps answering a bare array.

Path parameters

workspace_slug*string

Slug of the workspace that owns the waitlist (a renamed workspace's old slug still resolves).

waitlist_slug*string

Slug of the waitlist within its workspace.

Query parameters

limitinteger

Number of rows, 1 to 50. Defaults to 50; larger values are clamped to 50.

Response · 200 Array of `{ position, referral_count, masked_email }`

Array of object

position*integer

Signup position on the waitlist.

Example: 12

referral_count*integer

Number of honoured referrals.

Example: 4

masked_email*string

Masked email, e.g. `a***@example.com`.

Example: "a***@example.com"

Example

Request

GET https://api.waitlist.productcraft.co/v1/waitlists/{workspace_slug}/{waitlist_slug}/leaderboard

Response

[
  {
    "position": 12,
    "referral_count": 4,
    "masked_email": "a***@example.com"
  }
]