> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Waitlist Entries API

> Een Waitlist Entry is de inschrijving van een gebruiker voor een variant waarvoor goedkeuring van de verkoper vereist is.

Inschrijven geeft geen membership en brengt geen kosten in rekening op een betaalmethode; de verkoper keurt elke inschrijving goed of af.

Gebruik de Waitlist Entries API om je in te schrijven op een wachtlijst, je eigen inschrijvingen te lezen of te annuleren, en inschrijvingen voor accounts die je beheert goed te keuren of af te wijzen.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Waitlist Entries opvragen](https://docs.whop.com/nl/api-reference/waitlist-entries/list-waitlist-entries.md) | GET `/waitlist_entries` |
| [Waitlist Entry ophalen](https://docs.whop.com/nl/api-reference/waitlist-entries/retrieve-waitlist-entry.md) | GET `/waitlist_entries/{id}` |
| [Waitlist Entry aanmaken](https://docs.whop.com/nl/api-reference/waitlist-entries/create-waitlist-entry.md) | POST `/waitlist_entries` |
| [Waitlist Entry goedkeuren](https://docs.whop.com/nl/api-reference/waitlist-entries/approve-waitlist-entry.md) | POST `/waitlist_entries/{id}/approve` |
| [Waitlist Entry annuleren](https://docs.whop.com/nl/api-reference/waitlist-entries/cancel-waitlist-entry.md) | POST `/waitlist_entries/{id}/cancel` |
| [Waitlist Entry afwijzen](https://docs.whop.com/nl/api-reference/waitlist-entries/deny-waitlist-entry.md) | POST `/waitlist_entries/{id}/deny` |
| [Alle Waitlist Entries goedkeuren](https://docs.whop.com/nl/api-reference/waitlist-entries/approve-all-waitlist-entries.md) | POST `/waitlist_entries/approve_all` |

## Attributen

**id** `string` *required*

De ID van de wachtlijstinschrijving, met prefix `entry_`.

**account\_id** `string` *required*

Het verkopersaccount, met prefix `biz_`.

**approval\_failure\_reason** `string | null` *required*

Waarom de laatste goedkeuringspoging is mislukt, of `null` wanneer dat niet is gebeurd. `plan_unavailable` — de variant, het product of het verkopersaccount is verwijderd. `already_member` — de gebruiker heeft al een membership voor een product met één per gebruiker. `checkout_failed` — de checkout is mislukt, meestal door een geweigerde betaling, en de inschrijving is afgewezen. `unknown` — een andere fout; probeer het opnieuw. Wordt gewist wanneer de goedkeuring opnieuw in de wachtrij wordt gezet.

Beschikbare opties: `plan_unavailable`, `already_member`, `checkout_failed`, `unknown`

**buyer\_account** `object | null` *required*

Het account namens welke de inschrijving is ingediend, of `null` wanneer de gebruiker zich voor zichzelf heeft ingeschreven.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Account-ID, met prefix `biz_`.
>
> **logo\_url** `string | null` *required*
>
> URL van de logoafbeelding van het account. `null` wanneer het account er geen heeft ingesteld.
>
> **route** `string` *required*
>
> Openbare route-identifier van het account, gebruikt in het storefront-pad `whop.com/\{route}`.
>
> **title** `string` *required*
>
> Weergavenaam van het account.

**buyer\_account\_id** `string | null` *required*

Het account namens welke de inschrijving is ingediend, met prefix `biz_`, of `null` wanneer de gebruiker zich voor zichzelf heeft ingeschreven.

**created\_at** `string` *required*

Wanneer deze inschrijving is ingediend, als ISO 8601-tijdstempel.

**custom\_field\_responses** `object[]` *required*

De antwoorden van de koper op checkoutvragen.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> De ID van het antwoord, met prefix `cfrp_`.
>
> **answer** `string` *required*
>
> Het antwoord van de koper.
>
> **question** `string` *required*
>
> De vraag die werd getoond toen de inschrijving werd ingediend.

**membership\_id** `string | null` *required*

De membership die voor deze inschrijving is aangemaakt, met prefix `mem_`, of `null` wanneer er geen is. Controleer de status van de membership om de toegang te bepalen.

**metadata** `object` *required*

Aangepaste sleutel-waardemetadata die aan deze inschrijving is gekoppeld.

**product** `object | null` *required*

Het product waartoe deze inschrijving behoort, of `null` wanneer de variant geen product heeft.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Product-ID, met prefix `prod_`.
>
> **title** `string` *required*
>
> Weergavenaam van het product.

**product\_id** `string | null` *required*

Het product waartoe deze inschrijving behoort, met prefix `prod_`, of `null` wanneer de variant geen product heeft.

**status** `string` *required*

De huidige status van de inschrijving. Goedkeuring verloopt asynchroon, dus een inschrijving blijft `pending` totdat de verwerking is voltooid. `approved` alleen bewijst geen actieve membership; controleer `membership_id`.

Beschikbare opties: `pending`, `approved`, `denied`, `canceled`

**updated\_at** `string` *required*

Wanneer deze inschrijving voor het laatst is gewijzigd, als ISO 8601-tijdstempel.

**user** `object` *required*

De gebruiker die deze inschrijving heeft ingediend. Voor een inschrijving die door de eigen credential van een account is ingediend: de eigenaar van het account.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Gebruikers-ID, met prefix `user_`.
>
> **name** `string | null` *required*
>
> Weergavenaam.
>
> **profile\_picture** `object` *required*
>
> Avatar-wrapper. De `url` is altijd aanwezig en is een gegenereerde placeholder wanneer de gebruiker geen afbeelding heeft ingesteld.
>
> > [accordion] Eigenschappen
> >
> > **url** `string` *required*
> >
> > URL van de avatarafbeelding. Altijd aanwezig. Dit is een gegenereerde placeholder wanneer de gebruiker geen afbeelding heeft ingesteld.
>
> **username** `string` *required*
>
> Openbare gebruikersnaam.

**user\_id** `string` *required*

De gebruiker die deze inschrijving heeft ingediend, met prefix `user_`. Voor een inschrijving die door de eigen credential van een account is ingediend: de eigenaar van het account.

**variant** `object` *required*

De variant waartoe deze inschrijving behoort.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Variant-ID, met prefix `plan_`.
>
> **billing\_period** `number | null` *required*
>
> Aantal dagen tussen terugkerende afschrijvingen, zoals 30 voor maandelijks of 365 voor jaarlijks. `null` voor eenmalige varianten.
>
> **billing\_type** `string` *required*
>
> Factureringsmodel voor deze variant: `one_time` of `renewal`.
>
> Beschikbare opties: `renewal`, `one_time`
>
> **description** `string | null` *required*
>
> Voor de klant zichtbare variantbeschrijving. Maximaal 1000 tekens. `null` als er geen beschrijving is ingesteld.
>
> **initial\_price** `object` *required*
>
> Wat de checkout vooraf in rekening brengt. `amount` is `"0.00"` wanneer de eerste afschrijving gratis is, zoals bij een proefperiode.
>
> > [accordion] Eigenschappen
> >
> > **amount** `string` *required*
> >
> > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> >
> > **currency** `string` *required*
> >
> > Driecijferige ISO 4217-valutacode, in kleine letters.
> >
> > **decimals** `integer` *required*
> >
> > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> >
> > **display\_decimals** `integer` *required*
> >
> > Hoeveel decimalen er moeten worden WEERGEGEVEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
>
> **renewal\_price** `object` *required*
>
> De terugkerende afschrijving elke `billing_period` dagen. `amount` is `"0.00"` voor eenmalige varianten.
>
> > [accordion] Eigenschappen
> >
> > **amount** `string` *required*
> >
> > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> >
> > **currency** `string` *required*
> >
> > Driecijferige ISO 4217-valutacode, in kleine letters.
> >
> > **decimals** `integer` *required*
> >
> > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> >
> > **display\_decimals** `integer` *required*
> >
> > Hoeveel decimalen er moeten worden WEERGEGEVEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
>
> **title** `string | null` *required*
>
> Weergavenaam van de variant die aan klanten wordt getoond. `null` als er geen titel is ingesteld.
>
> **trial\_period\_days** `number | null` *required*
>
> Geconfigureerde dagen gratis proefperiode vóór de eerste verlengingsafschrijving. `null` als er geen proefperiode is geconfigureerd.

**variant\_id** `string` *required*

De variant waartoe deze inschrijving behoort, met prefix `plan_`.

```json WaitlistEntry theme={null}
{
	"id": "entry_xxxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"product_id": "prod_xxxxxxxxxxxxxx",
	"product": {
		"id": "prod_xxxxxxxxxxxxxx",
		"title": "Pro Community"
	},
	"variant_id": "plan_xxxxxxxxxxxxxx",
	"variant": {
		"id": "plan_xxxxxxxxxxxxxx",
		"title": "Monthly",
		"description": "Billed monthly. Cancel anytime.",
		"billing_type": "renewal",
		"billing_period": 30,
		"initial_price": {
			"currency": "usd",
			"amount": "10.00",
			"decimals": 2,
			"display_decimals": 2
		},
		"renewal_price": {
			"currency": "usd",
			"amount": "10.00",
			"decimals": 2,
			"display_decimals": 2
		},
		"trial_period_days": 7
	},
	"user_id": "user_xxxxxxxxxxxxxx",
	"user": {
		"id": "user_xxxxxxxxxxxxxx",
		"username": "jordan_lee",
		"name": "Jordan Lee",
		"profile_picture": {
			"url": "https://img.whop.com/jordan.png"
		}
	},
	"buyer_account_id": null,
	"buyer_account": null,
	"status": "approved",
	"membership_id": "mem_xxxxxxxxxxxxxx",
	"approval_failure_reason": null,
	"custom_field_responses": [
		{
			"id": "cufi_xxxxxxxxxxxxxx",
			"question": "What car do you drive?",
			"answer": "2021 Tesla Model 3"
		}
	],
	"metadata": {},
	"created_at": "2026-09-12T10:15:00.000Z",
	"updated_at": "2026-09-13T08:02:44.000Z"
}
```


## Related topics

- [Cancel Waitlist Entry](https://docs.whop.com/nl/api-reference/waitlist-entries/cancel-waitlist-entry.md)
- [List Waitlist Entries](https://docs.whop.com/nl/api-reference/waitlist-entries/list-waitlist-entries.md)
- [Retrieve Waitlist Entry](https://docs.whop.com/nl/api-reference/waitlist-entries/retrieve-waitlist-entry.md)
