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

# Vérifier le statut d'une vérification

> Listez les vérifications KYC et KYB d'un compte ou récupérez-en une par son ID, et découvrez la signification de chaque statut.

## Lister les vérifications d'un compte

Transmettez l'identifiant `biz_` du compte dans le paramètre de requête `account_id` pour obtenir toutes les vérifications de ce compte. Un compte en possède au maximum deux — une vérification Know Your Customer (KYC) individuelle et une vérification Know Your Business (KYB).

```bash cURL theme={null}
curl "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY"
```

```json Response theme={null}
{
  "data": [
    {
      "id": "idpf_xxxxxxxxxxxxx",
      "kind": "individual",
      "status": "approved",
      "first_name": "Jane",
      "last_name": "Doe",
      "date_of_birth": "1995-01-15",
      "country": "US",
      "address": {
        "line1": "123 Main St",
        "city": "San Francisco",
        "state": "CA",
        "postal_code": "94105"
      },
      "requested_information": [],
      "created_at": "2026-06-03T22:15:00Z",
      "updated_at": "2026-06-04T10:00:00Z"
    }
  ]
}
```

## Récupérer une seule vérification

Transmettez un identifiant `idpf_` dans le chemin pour lire directement un profil.

```bash cURL theme={null}
curl https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY"
```

La réponse est un objet vérification unique (de même forme qu'une entrée du tableau `data` de la liste).

## Statuts

| Statut | Signification | Que faire |
| - | - | - |
| `pending` | L'utilisateur n'a pas encore terminé le KYC | Envoyez-le vers `session_url` |
| `approved` | Identité vérifiée | L'utilisateur peut effectuer des transactions |
| `rejected` | KYC refusé | Créez une nouvelle vérification avec `restart: true` |
| `action_required` | Whop a besoin de plus d'informations | Consultez le tableau `requested_information` — voir [Traiter les RFI](https://docs.whop.com/fr/developer/verification/rfis.md) |
| `not_started` | Le profil existe, aucune session n'a été lancée | Appelez la création pour démarrer |

> [!NOTE]
>
> `session_url` n'apparaît que lorsque `status` vaut `pending` — cela signifie que l'utilisateur doit encore terminer le KYC. Une fois la vérification approuvée ou refusée, l'URL disparaît.

## Champs de la réponse

Les champs dépendent de `kind`. Les vérifications individuelles renvoient des champs personnels, les vérifications d'entreprise renvoient des champs de compte.

### Particulier (`kind: "individual"`)

| Champ | Type | Description |
| - | - | - |
| `first_name` | `string` | Prénom légal vérifié |
| `last_name` | `string` | Nom de famille légal vérifié |
| `date_of_birth` | `string` | Date au format de l'Organisation internationale de normalisation (ISO) (par ex. `1995-01-15`) |
| `country` | `string` | Code pays ISO |
| `address` | `object` | Adresse de résidence vérifiée |

### Entreprise (`kind: "business"`)

| Champ | Type | Description |
| - | - | - |
| `business_name` | `string` | Nom vérifié de l'entité juridique |
| `business_structure` | `string` | Structure de l'entité juridique, comme `private_corporation` ou `sole_proprietorship` — voir [Structures d'entreprise](https://docs.whop.com/fr/developer/verification/business-structures.md) |
| `registration_number` | `string` | Numéro vérifié sous lequel l'entreprise a été immatriculée dans son lieu de constitution, comme un numéro d'enregistrement d'État aux États-Unis |
| `country` | `string` | Code pays ISO |
| `address` | `object` | Adresse enregistrée de l'entreprise |

## Authentification

Nécessite une clé API de compte avec le scope `identity:read`.

### Erreurs

| Statut | Message | Quand |
| - | - | - |
| `400` | `account_id is required` | Aucun identifiant `biz_` fourni |
| `401` | — | Clé API manquante ou invalide |
| `403` | — | La clé API ne dispose pas du scope `identity:read` |
| `404` | `Account not found` | L'identifiant `biz_` n'existe pas ou vous n'y avez pas accès |
