> ## 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.

# API Entrées de liste d'attente

> Une entrée de liste d'attente est l'inscription d'un utilisateur à une variante qui nécessite l'approbation du vendeur.

L'inscription n'accorde pas d'adhésion et ne débite aucun moyen de paiement ; le vendeur approuve ou refuse chaque inscription.

Utilisez l'API Entrées de liste d'attente pour rejoindre une liste d'attente, consulter ou annuler vos propres inscriptions, et approuver ou refuser les inscriptions des comptes que vous gérez.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les entrées de liste d'attente](https://docs.whop.com/fr/api-reference/waitlist-entries/list-waitlist-entries.md) | GET `/waitlist_entries` |
| [Récupérer une entrée de liste d'attente](https://docs.whop.com/fr/api-reference/waitlist-entries/retrieve-waitlist-entry.md) | GET `/waitlist_entries/{id}` |
| [Créer une entrée de liste d'attente](https://docs.whop.com/fr/api-reference/waitlist-entries/create-waitlist-entry.md) | POST `/waitlist_entries` |
| [Approuver une entrée de liste d'attente](https://docs.whop.com/fr/api-reference/waitlist-entries/approve-waitlist-entry.md) | POST `/waitlist_entries/{id}/approve` |
| [Annuler une entrée de liste d'attente](https://docs.whop.com/fr/api-reference/waitlist-entries/cancel-waitlist-entry.md) | POST `/waitlist_entries/{id}/cancel` |
| [Refuser une entrée de liste d'attente](https://docs.whop.com/fr/api-reference/waitlist-entries/deny-waitlist-entry.md) | POST `/waitlist_entries/{id}/deny` |
| [Approuver toutes les entrées de liste d'attente](https://docs.whop.com/fr/api-reference/waitlist-entries/approve-all-waitlist-entries.md) | POST `/waitlist_entries/approve_all` |

## Attributs

**id** `string` *required*

L'ID de l'inscription à la liste d'attente, préfixé par `entry_`.

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

Le compte vendeur, préfixé par `biz_`.

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

Raison de l'échec de la dernière tentative d'approbation, ou `null` s'il n'y en a eu aucun. `plan_unavailable` — la variante, le produit ou le compte vendeur a été supprimé. `already_member` — l'utilisateur a déjà une adhésion sur un produit limité à une par utilisateur. `checkout_failed` — le checkout a échoué, généralement en raison d'un paiement refusé, et l'inscription a été refusée. `unknown` — un autre échec ; réessayez. Effacé lorsque l'approbation est remise en file d'attente.

Options disponibles : `plan_unavailable`, `already_member`, `checkout_failed`, `unknown`

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

Le compte au nom duquel l'inscription a été soumise, ou `null` lorsque l'utilisateur s'est inscrit pour lui-même.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du compte, préfixé par `biz_`.
>
> **logo\_url** `string | null` *required*
>
> URL de l'image du logo du compte. `null` lorsque le compte n'en a pas défini.
>
> **route** `string` *required*
>
> Identifiant de route public du compte, utilisé dans le chemin de la vitrine `whop.com/\{route}`.
>
> **title** `string` *required*
>
> Nom d'affichage du compte.

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

Le compte au nom duquel l'inscription a été soumise, préfixé par `biz_`, ou `null` lorsque l'utilisateur s'est inscrit pour lui-même.

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

Date de soumission de cette inscription, sous forme d'horodatage ISO 8601.

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

Les réponses de l'acheteur aux questions du checkout.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'ID de la réponse, préfixé par `cfrp_`.
>
> **answer** `string` *required*
>
> La réponse de l'acheteur.
>
> **question** `string` *required*
>
> La question affichée lors de la soumission de l'inscription.

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

L'adhésion créée pour cette inscription, préfixée par `mem_`, ou `null` s'il n'y en a pas. Vérifiez le statut de l'adhésion pour déterminer l'accès.

**metadata** `object` *required*

Métadonnées clé-valeur personnalisées associées à cette inscription.

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

Le produit auquel appartient cette inscription, ou `null` lorsque la variante n'a pas de produit.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du produit, préfixé par `prod_`.
>
> **title** `string` *required*
>
> Nom d'affichage du produit.

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

Le produit auquel appartient cette inscription, préfixé par `prod_`, ou `null` lorsque la variante n'a pas de produit.

**status** `string` *required*

L'état actuel de l'inscription. L'approbation s'exécute de manière asynchrone, de sorte qu'une inscription reste `pending` jusqu'à la fin du traitement. `approved` seul ne prouve pas l'existence d'une adhésion active ; vérifiez `membership_id`.

Options disponibles : `pending`, `approved`, `denied`, `canceled`

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

Date de dernière modification de cette inscription, sous forme d'horodatage ISO 8601.

**user** `object` *required*

L'utilisateur qui a soumis cette inscription. Pour une inscription soumise par les propres identifiants d'un compte, le propriétaire du compte.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID de l'utilisateur, préfixé par `user_`.
>
> **name** `string | null` *required*
>
> Nom d'affichage.
>
> **profile\_picture** `object` *required*
>
> L'objet contenant l'avatar. Son `url` est toujours présente et correspond à une image de remplacement générée lorsque l'utilisateur n'a défini aucune photo.
>
> > [accordion] Propriétés
> >
> > **url** `string` *required*
> >
> > URL de l'image de l'avatar. Toujours présente. Il s'agit d'une image de remplacement générée lorsque l'utilisateur n'a défini aucune photo.
>
> **username** `string` *required*
>
> Nom d'utilisateur public.

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

L'utilisateur qui a soumis cette inscription, préfixé par `user_`. Pour une inscription soumise par les propres identifiants d'un compte, le propriétaire du compte.

**variant** `object` *required*

La variante à laquelle appartient cette inscription.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID de la variante, préfixé par `plan_`.
>
> **billing\_period** `number | null` *required*
>
> Nombre de jours entre les prélèvements récurrents, par exemple 30 pour un abonnement mensuel ou 365 pour un abonnement annuel. `null` pour les variantes à paiement unique.
>
> **billing\_type** `string` *required*
>
> Modèle de facturation de cette variante : `one_time` ou `renewal`.
>
> Options disponibles : `renewal`, `one_time`
>
> **description** `string | null` *required*
>
> Description de la variante visible par le client. 1000 caractères maximum. `null` si aucune description n'est définie.
>
> **initial\_price** `object` *required*
>
> Ce que le checkout prélève immédiatement. `amount` vaut `"0.00"` lorsque le premier prélèvement est gratuit, comme pendant un essai.
>
> > [accordion] Propriétés
> >
> > **amount** `string` *required*
> >
> > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> >
> > **currency** `string` *required*
> >
> > Code de devise ISO 4217 à trois lettres, en minuscules.
> >
> > **decimals** `integer` *required*
> >
> > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> >
> > **display\_decimals** `integer` *required*
> >
> > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
>
> **renewal\_price** `object` *required*
>
> Le prélèvement récurrent tous les `billing_period` jours. `amount` vaut `"0.00"` pour les variantes à paiement unique.
>
> > [accordion] Propriétés
> >
> > **amount** `string` *required*
> >
> > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> >
> > **currency** `string` *required*
> >
> > Code de devise ISO 4217 à trois lettres, en minuscules.
> >
> > **decimals** `integer` *required*
> >
> > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> >
> > **display\_decimals** `integer` *required*
> >
> > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
>
> **title** `string | null` *required*
>
> Nom d'affichage de la variante présenté aux clients. `null` si aucun titre n'a été défini.
>
> **trial\_period\_days** `number | null` *required*
>
> Jours d'essai gratuit configurés avant le premier prélèvement de renouvellement. `null` si aucun essai n'est configuré.

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

La variante à laquelle appartient cette inscription, préfixée par `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"
}
```
