> ## 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 Vérifications

> Une vérification représente l'identité légale d'une personne ou d'une entreprise.

Les comptes et les utilisateurs effectuent une vérification lorsque Whop doit confirmer leur identité avant d'activer les versements ou des flux de travail sensibles en matière de conformité.

Utilisez l'API Vérifications pour démarrer ou reprendre une session de vérification hébergée, consulter le statut de l'examen, et soumettre les informations ou documents demandés. Si `requested_information` contient des éléments, soumettez les réponses avec [Mettre à jour une vérification](https://docs.whop.com/fr/api-reference/verifications/update-verification.md).

> [!NOTE]
>
> Remplace la ressource Legacy [Vérifications](https://docs.whop.com/fr/api-reference/verifications/verification). Les intégrations Legacy existantes continuent de fonctionner ; consultez [Versions de l'API](https://docs.whop.com/fr/developer/api/versioning.md) pour le contrat de stabilité.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les vérifications](https://docs.whop.com/fr/api-reference/verifications/list-verifications.md) | GET `/verifications` |
| [Récupérer une vérification](https://docs.whop.com/fr/api-reference/verifications/retrieve-verification.md) | GET `/verifications/{id}` |
| [Créer une vérification](https://docs.whop.com/fr/api-reference/verifications/create-verification.md) | POST `/verifications` |
| [Mettre à jour une vérification](https://docs.whop.com/fr/api-reference/verifications/update-verification.md) | PATCH `/verifications/{id}` |

## Attributs

**id** `string`

ID du profil de vérification, préfixé par `idpf_`.

**account\_ids** `string[]` *required*

Comptes pour lesquels cette vérification a été lue, chacun préfixé par `biz_` : le compte par lequel vous avez listé, le compte ou sous-compte auquel elle appartient avec `include_subaccounts`, ou tous les comptes que vous pouvez lire auxquels elle appartient lorsqu'elle est récupérée par ID. Généralement un seul. Vide pour une vérification personnelle.

**address** `object | null`

Adresse figurant sur le profil de vérification. `null` lorsqu'aucune adresse n'est définie.

> [accordion] Propriétés
>
> **city** `string | null`
>
> **country** `string | null`
>
> Code pays ISO 3166-1 à deux lettres, par exemple `US`, `DE` ou `GB`.
>
> **line1** `string`
>
> Première ligne de l'adresse postale.
>
> **line2** `string | null`
>
> Deuxième ligne de l'adresse postale.
>
> **postal\_code** `string | null`
>
> Code postal.
>
> **state** `string | null`
>
> Code de l'État, de la province ou de la région, par exemple `CA`.

**business\_name** `string | null`

Raison sociale de l'entreprise.

**business\_structure** `string | null`

Structure juridique de l'entreprise, telle que `private_corporation` ou `sole_proprietorship`. Les valeurs prises en charge varient selon le pays de constitution — voir [Structures d'entreprise](https://docs.whop.com/fr/developer/verification/business-structures.md).

**country** `string | null`

Code pays ISO 3166-1 à deux lettres, par exemple `US`, `DE` ou `GB`.

**created\_at** `string`

Date de création du profil de vérification, sous forme d'horodatage ISO 8601.

**date\_of\_birth** `string | null`

Au format `YYYY-MM-DD`.

**email** `string | null`

Adresse e-mail figurant sur le profil de vérification.

**first\_name** `string | null`

**incorporation\_date** `string | null`

Date de constitution de l'entreprise, au format `YYYY-MM-DD`, telle qu'enregistrée pour la vérification d'entreprise. Vérifications d'entreprise uniquement ; `null` jusqu'à son envoi.

**kind** `string`

Options disponibles : `individual`, `business`

**last\_name** `string | null`

**owners** `object[]` *required*

Propriétaires de l'entreprise et avancement de la vérification propre à chacun. Vide pour les vérifications individuelles.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du propriétaire, préfixé par `own_`. Envoyez-le dans le champ `owners` de Update Verification pour modifier ou supprimer le propriétaire, y compris un propriétaire ajouté dans la session hébergée.
>
> **date\_of\_birth** `string | null` *required*
>
> La date de naissance enregistrée du propriétaire, au format `YYYY-MM-DD`.
>
> **first\_name** `string | null` *required*
>
> **last\_name** `string | null` *required*
>
> **ownership\_percentage** `number | null` *required*
>
> Part de l'entreprise détenue par la personne, de 0 à 100.
>
> **rejected\_checks** `string[]` *required*
>
> Ce que le fournisseur a rejeté lorsque la vérification du propriétaire a été renvoyée : `details` (son nom, sa date de naissance ou d'autres informations ne correspondent pas à sa pièce d'identité), `identity_document` ou `selfie`. Corrigez uniquement ces éléments avec Update Verification. Vide sinon.
>
> Options disponibles : `details`, `identity_document`, `selfie`
>
> **required\_documents** `object[]` *required*
>
> Les documents du propriétaire et leur avancement. Vide pour un propriétaire ajouté avec `verification_id`.
>
> > [accordion] Propriétés
> >
> > **document** `string`
> >
> > Clé d'emplacement du document, telle que `id_card_front`, `id_card_back` ou `selfie`.
> >
> > **rejection\_reason** `string | null`
> >
> > Raison du rejet de la soumission précédente, lorsque le fournisseur a demandé de nouveaux documents ou refusé la vérification.
> >
> > **status** `string`
> >
> > `pending_upload` jusqu'à ce que le document ait été transmis pour examen ; `submitted` ensuite.
> >
> > Options disponibles : `pending_upload`, `submitted`
>
> **roles** `string[]` *required*
>
> Le rôle de la personne au sein de l'entreprise.
>
> Options disponibles : `ubo`, `director`, `representative`, `shareholder`
>
> **status** `string` *required*
>
> L'état de la vérification propre au propriétaire, avec les mêmes états que `status`. `action_required` lorsque ses documents doivent être renvoyés.
>
> Options disponibles : `not_started`, `pending`, `processing`, `manual_review`, `approved`, `rejected`, `action_required`

**phone** `string | null`

Numéro de téléphone figurant sur le profil de vérification.

**place\_of\_incorporation** `string | null`

État ou région de constitution de l'entreprise, tel qu'enregistré pour la vérification d'entreprise. Vérifications d'entreprise uniquement ; `null` jusqu'à son envoi.

**registration\_number** `string | null`

Numéro sous lequel l'entreprise a été immatriculée dans son lieu de constitution, tel qu'un numéro d'enregistrement d'État aux États-Unis ou un Company Number au Royaume-Uni. Vérifications d'entreprise uniquement ; tel qu'enregistré pour la vérification d'entreprise, ou `null` jusqu'à son envoi.

**requested\_information** `object[]`

Ce dont Whop a encore besoin avant que l'examen puisse se poursuivre, avec une exigence par entrée. Répondez avec Update Verification. Rien de la réponse n'est renvoyé. Les clés non applicables sont omises. Pour une vérification d'entreprise créée avec `documents` ou `owners`, cela inclut les informations et documents de l'entreprise encore manquants avant qu'elle puisse être envoyée pour examen. Les documents de chaque propriétaire sont listés sous ce propriétaire.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID de l'élément d'information demandé, préfixé par `inrqi_`.
>
> **action\_url** `string`
>
> URL d'une action associée, comme terminer la vérification du caractère vivant ou consulter un paiement. Absente lorsqu'aucune action n'est disponible.
>
> **alternative\_document\_label** `string`
>
> Un document qui répond à cet élément à la place de `value`, comme une lettre EIN de l'IRS lorsque l'EIN n'a pas pu être rapproché. Envoyez ses pages dans `files`, avec ou sans `value` corrigée. Absent lorsque seule `value` est acceptée.
>
> **details\_label** `string`
>
> Question complémentaire affichée avec cette exigence.
>
> **details\_required** `boolean`
>
> Indique si la réponse complémentaire est obligatoire lorsqu'elle est visible.
>
> **details\_visible\_for** `string[]`
>
> Valeurs d'options sélectionnées qui rendent la question complémentaire visible.
>
> **errors** `object[]`
>
> Présent après une soumission rejetée.
>
> > [accordion] Propriétés
> >
> > **code** `string`
> >
> > Code d'erreur stable.
> >
> > **reason** `string`
> >
> > Raison du rejet.
>
> **label** `string` *required*
>
> Instruction à afficher à l'utilisateur. Reprend mot pour mot la note de l'examinateur lorsqu'il y en a une.
>
> **optional** `boolean`
>
> `true` lorsque l'élément peut être ignoré.
>
> **options** `string[]`
>
> Les valeurs que `value` peut prendre pour un élément `select`. Pour un élément `id_document`, il s'agit des types de pièces d'identité acceptés, et celui choisi détermine les emplacements `documents` à envoyer. Absent lorsque l'élément n'implique aucun choix.
>
> **requirement** `string` *required*
>
> Ce qui est requis : un nom de document tel que `bank_statement`, ou une clé de champ telle que `ssn` ou `identity_document`. Traitez les valeurs non reconnues selon `type`.
>
> **response\_type** `string`
>
> Format de saisie natif facultatif pour une réponse textuelle.
>
> Options disponibles : `yes_no`, `yes_no_na`, `date`, `url`, `number`, `tel`
>
> **selection\_mode** `string`
>
> Indique si une question avec `options` accepte une seule valeur ou plusieurs valeurs.
>
> Options disponibles : `single`, `multiple`
>
> **supporting\_documents** `object[]`
>
> Documents fournis avec l'exigence à titre de contexte.
>
> > [accordion] Propriétés
> >
> > **id** `string` *required*
> >
> > L'ID du fichier, préfixé par `file_`.
> >
> > **blurhash** `string | null` *required*
> >
> > Espace réservé BlurHash pour une image ou une vidéo. Null lorsqu'il n'est pas disponible ou qu'il a été supprimé par la modération.
> >
> > **content\_type** `string | null` *required*
> >
> > Le type MIME du fichier d'origine, par exemple `application/pdf`. Il est conservé lorsque la modération supprime le fichier.
> >
> > **created\_at** `string` *required*
> >
> > Date de création du fichier, sous forme d'horodatage ISO 8601.
> >
> > **duration\_seconds** `number | null` *required*
> >
> > Durée de l'audio ou de la vidéo en secondes. Null lorsqu'elle n'est pas disponible ou qu'elle a été supprimée par la modération.
> >
> > **filename** `string | null` *required*
> >
> > Le nom de fichier d'origine, extension comprise.
> >
> > **height** `integer | null` *required*
> >
> > Hauteur de l'image ou de la vidéo en pixels. Null lorsqu'elle n'est pas disponible ou qu'elle a été supprimée par la modération.
> >
> > **multipart\_chunk\_size** `integer | null`
> >
> > La taille en octets que doit avoir chaque partie (sauf la dernière). Présent uniquement à la création, et uniquement pour les téléversements multiparties.
> >
> > **multipart\_upload\_id** `string | null`
> >
> > L'ID du téléversement multipartie, à renvoyer à `complete`. Présent uniquement à la création, et uniquement pour les téléversements multiparties.
> >
> > **multipart\_upload\_urls** `object[] | null`
> >
> > L'URL présignée de chaque partie. Présent uniquement à la création, et uniquement pour les téléversements multiparties.
> >
> > > [accordion] Propriétés
> > >
> > > **part\_number** `integer` *required*
> > >
> > > L'index (commençant à 1) de cette partie dans le téléversement multipartie.
> > >
> > > **url** `string` *required*
> > >
> > > L'URL présignée vers laquelle envoyer (PUT) les octets de cette partie.
> >
> > **object** `string` *required*
> >
> > Le type de cet objet, toujours `file`.
> >
> > **removed\_by\_moderation** `boolean` *required*
> >
> > Indique si la modération a supprimé le fichier. Lorsque `true`, `url` sert une image de remplacement. `filename`, `size` et `content_type` décrivent toujours le fichier d'origine.
> >
> > **size** `integer | null` *required*
> >
> > La taille du fichier en octets. `null` tant que le téléversement n'est pas terminé.
> >
> > **upload\_headers** `object`
> >
> > En-têtes à envoyer avec le PUT de téléversement. Présent uniquement à la création.
> >
> > **upload\_status** `string` *required*
> >
> > L'étape du cycle de téléversement à laquelle se trouve le fichier.
> >
> > Options disponibles : `pending`, `processing`, `ready`, `failed`
> >
> > **upload\_url** `string | null`
> >
> > URL présignée vers laquelle envoyer (PUT) les octets du fichier. Présent uniquement à la création, et uniquement pour les téléversements en une seule partie.
> >
> > **url** `string | null` *required*
> >
> > Une URL pour télécharger le fichier. Les fichiers publics reçoivent une URL CDN permanente, et les fichiers privés une URL signée qui expire. `null` tant que le téléversement n'est pas terminé. Lorsque la modération supprime le fichier, une URL d'image de remplacement.
> >
> > **visibility** `string` *required*
> >
> > Les fichiers `public` sont servis depuis une URL CDN non signée. Les fichiers `private` sont servis depuis une URL signée qui expire.
> >
> > Options disponibles : `public`, `private`
> >
> > **waveform\_url** `string | null` *required*
> >
> > URL de la forme d'onde audio. Null lorsqu'elle n'est pas disponible ou qu'elle a été supprimée par la modération.
> >
> > **width** `integer | null` *required*
> >
> > Largeur de l'image ou de la vidéo en pixels. Null lorsqu'elle n'est pas disponible ou qu'elle a été supprimée par la modération.
>
> **supporting\_files\_explanation\_allowed** `boolean`
>
> Indique si une explication écrite peut remplacer les fichiers justificatifs requis.
>
> **supporting\_files\_required** `boolean`
>
> Indique si cette exigence nécessite également des fichiers justificatifs.
>
> **supporting\_files\_visible\_for** `string[]`
>
> Valeurs d'options sélectionnées qui rendent visible le champ de fichiers justificatifs.
>
> **type** `string` *required*
>
> Ce qu'il faut envoyer comme réponse, afin que vous n'ayez jamais à le déduire : `files` (un document, sous forme de liste de ses pages), `id_document` (envoyez `documents` avec les clés d'emplacement de la pièce d'identité que vous téléversez), `text`, `date`, `phone` ou `select` (envoyez `value`), `text_with_files` (envoyez `value` et éventuellement `files`), `address` (envoyez `address`), ou `liveness` (ouvrez `action_url`, puis envoyez `value` à `true` une fois terminé).

**required\_documents** `object[]`

Documents d'une vérification par téléversement de documents et leur avancement. Présent uniquement sur les vérifications individuelles créées en envoyant `documents`. Les documents `pending_upload` n'ont pas encore été acceptés — renvoyez l'ensemble complet avec un nouvel appel à Create Verification.

> [accordion] Propriétés
>
> **document** `string`
>
> Clé d'emplacement du document, telle que `id_card_front`, `id_card_back` ou `selfie`.
>
> **rejection\_reason** `string | null`
>
> Raison du rejet de la soumission précédente, lorsque le fournisseur a demandé de nouveaux documents ou refusé la vérification.
>
> **status** `string`
>
> `pending_upload` jusqu'à ce que le document ait été transmis pour examen ; `submitted` ensuite.
>
> Options disponibles : `pending_upload`, `submitted`

**session\_url** `string | null`

URL de la session de vérification hébergée permettant à l'utilisateur d'effectuer les contrôles d'identité. Expire 7 jours après sa création.

**status** `string`

État actuel de la vérification. `not_started` avant l'existence de toute session ; `pending` tant qu'une session attend une action de l'utilisateur ; `processing` pendant l'exécution des contrôles automatisés du fournisseur sur une nouvelle soumission ; `action_required` lorsque `requested_information` attend des réponses ; `manual_review` pendant l'examen d'informations déjà envoyées — une réponse d'audit, ou un document détenu par le fournisseur de versements — rien à soumettre, généralement terminé sous 3 jours ouvrés ; `approved` en cas de succès ; `rejected` en cas d'échec. Appelez à nouveau Create Verification pour démarrer une nouvelle session.

Options disponibles : `not_started`, `pending`, `processing`, `manual_review`, `approved`, `rejected`, `action_required`

**updated\_at** `string`

Date de dernière mise à jour du profil de vérification, sous forme d'horodatage ISO 8601.

```json Verification theme={null}
{
	"id": "idpf_xxxxxxxxxxxx",
	"account_ids": ["biz_xxxxxxxxxxxxxx"],
	"address": {
		"city": "New York",
		"country": "US",
		"line1": "123 Spring Street",
		"line2": "Apt 4B",
		"postal_code": "10012",
		"state": "NY"
	},
	"owners": [
		{
			"id": "idpf_xxxxxxxxxxxx",
			"first_name": "Riley",
			"last_name": "Owner",
			"date_of_birth": "1985-06-01",
			"ownership_percentage": 60,
			"required_documents": [
				{
					"document": "passport_front",
					"rejection_reason": null,
					"status": "submitted"
				},
				{
					"document": "selfie",
					"rejection_reason": null,
					"status": "submitted"
				}
			],
			"roles": ["ubo", "director"],
			"status": "processing",
			"rejected_checks": []
		}
	],
	"business_name": null,
	"business_structure": null,
	"country": "US",
	"created_at": "2026-06-01T12:00:00Z",
	"date_of_birth": "1990-01-01",
	"email": "alex@example.com",
	"first_name": "Alex",
	"kind": "individual",
	"last_name": "Rivera",
	"phone": "+15551234567",
	"registration_number": null,
	"requested_information": [
		{
			"id": "inrqi_xxxxxxxxxxx",
			"label": "Identity document",
			"options": ["PASSPORT", "ID_CARD", "DRIVERS", "RESIDENCE_PERMIT"],
			"requirement": "identity_document",
			"type": "id_document"
		},
		{
			"id": "inrqi_yyyyyyyyyyy",
			"label": "Bank Statement or a check for account ending in 4242",
			"requirement": "bank_statement",
			"type": "files"
		}
	],
	"required_documents": [
		{
			"document": "id_card_front",
			"rejection_reason": null,
			"status": "submitted"
		},
		{
			"document": "id_card_back",
			"rejection_reason": null,
			"status": "submitted"
		},
		{
			"document": "selfie",
			"rejection_reason": null,
			"status": "submitted"
		}
	],
	"session_url": "https://verify.whop.com/session/idpf_xxxxxxxxxxxx",
	"status": "action_required",
	"updated_at": "2026-06-02T12:00:00Z"
}
```


## Related topics

- [Vérification](https://docs.whop.com/fr/api-reference/legacy/verifications/verification.md)
- [Verifications](https://docs.whop.com/fr/elements/latest/verifications/overview.md)
- [List verifications](https://docs.whop.com/fr/api-reference/legacy/verifications/list-verifications.md)
