/v1/workspaces/{workspace_id}/waitlists/{id}AuthGet waitlist details
The waitlist with its settings, `allowed_origins`, and whether it accepts public sign-ups now (`accepting_signups`, `signups_note`).
Path parameters
id*string · uuidId of the waitlist.
workspace_id*string · uuidId of the workspace.
Response · 200 Waitlist row.
id*string · uuidWaitlist id.
Example: "33a8b309-8753-4f08-90d7-9dc484eff392"
workspace_id*string · uuidThe workspace that owns the waitlist.
Example: "9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b"
workspace_slug*stringSlug of the workspace, used in the public routes.
Example: "acme"
slug*stringWaitlist slug, unique in the workspace; used in the public routes.
Example: "early-access"
display_name*stringDisplay name.
Example: "Early Access Program"
description*stringDescription shown on the public info; null when unset.
status*object`active` accepts public sign-ups; `draft` and `paused` refuse them; `closed` ends the waitlist.
accepting_signups*booleanWhether the public sign-up endpoint accepts entries right now (only an `active` waitlist does).
Example: false
signups_note*stringPlain explanation when public sign-ups are refused, and how to open them; null when the waitlist is active.
Example: "This waitlist is a draft, so public sign-ups are refused (422) until you change its status to active."
allowed_origins*arrayWeb origins (scheme and host, for example `https://acme.com` or `http://localhost:3000`) that browsers may submit public sign-ups from. `https://*.acme.com` matches any subdomain. An empty list means any origin. A browser request from another origin gets 403 `ORIGIN_NOT_ALLOWED`; server-side calls without an `Origin` header are not checked. Entries are normalised (lower case, no trailing slash, default port dropped).
Example: []
settings*objectWaitlist settings (max_entries, approval_required, custom_fields, confirmation_message, referral_boost, referral_rewards, recaptcha_site_key). The reCAPTCHA secret key is never returned; recaptcha_secret_configured says whether one is saved.
created_by*stringId of the user or API key that created the waitlist.
previous_workspace_slug*stringThe workspace's slug before its last rename; the public routes still answer under it. Null when never renamed.
created_at*string · date-timeWhen the waitlist was created.
updated_at*string · date-timeWhen the waitlist was last changed.
Example
Request
GET https://api.waitlist.productcraft.co/v1/workspaces/{workspace_id}/waitlists/{id}
Authorization: Bearer YOUR_TOKENResponse
{
"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"
}