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

# Consultar el estado de una verificación

> Enumera las verificaciones KYC y KYB de una cuenta u obtén una por su ID, y consulta qué significa cada estado.

## Enumerar las verificaciones de una cuenta

Pasa la etiqueta `biz_` de la cuenta como parámetro de consulta `account_id` para obtener todas las verificaciones de esa cuenta. Una cuenta tiene como máximo dos: una verificación individual Know Your Customer (KYC) y una verificación 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"
    }
  ]
}
```

## Obtener una sola verificación

Pasa una etiqueta `idpf_` en la ruta para leer un perfil directamente.

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

La respuesta es un único objeto de verificación (con la misma forma que una entrada del array `data` de la lista).

## Estados

| Estado | Qué significa | Qué hacer |
| - | - | - |
| `pending` | El usuario aún no ha completado el KYC | Envíalo a `session_url` |
| `approved` | Identidad verificada | El usuario puede realizar transacciones |
| `rejected` | KYC rechazado | Crea una nueva verificación con `restart: true` |
| `action_required` | Whop necesita más información | Revisa el array `requested_information`; consulta [Gestionar RFI](https://docs.whop.com/es/developer/verification/rfis.md) |
| `not_started` | El perfil existe, pero no se ha iniciado ninguna sesión | Llama a create para empezar |

> [!NOTE]
>
> `session_url` solo aparece cuando `status` es `pending`, lo que significa que el usuario aún tiene que completar el KYC. Una vez aprobada o rechazada, la URL desaparece.

## Campos de la respuesta

Los campos dependen de `kind`. Las verificaciones individuales devuelven campos personales y las de empresa devuelven campos de la cuenta.

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

| Campo | Tipo | Descripción |
| - | - | - |
| `first_name` | `string` | Nombre legal verificado |
| `last_name` | `string` | Apellido legal verificado |
| `date_of_birth` | `string` | Fecha en formato de la Organización Internacional de Normalización (ISO) (p. ej., `1995-01-15`) |
| `country` | `string` | Código de país ISO |
| `address` | `object` | Dirección de residencia verificada |

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

| Campo | Tipo | Descripción |
| - | - | - |
| `business_name` | `string` | Nombre verificado de la entidad jurídica |
| `business_structure` | `string` | Estructura de la entidad jurídica, como `private_corporation` o `sole_proprietorship`; consulta [Estructuras empresariales](https://docs.whop.com/es/developer/verification/business-structures.md) |
| `registration_number` | `string` | Número verificado con el que se registró el negocio en su lugar de constitución, como un número de registro estatal en EE. UU. |
| `country` | `string` | Código de país ISO |
| `address` | `object` | Dirección registrada del negocio |

## Autenticación

Requiere una clave de API de Account con el scope `identity:read`.

### Errores

| Estado | Mensaje | Cuándo |
| - | - | - |
| `400` | `account_id is required` | No se proporcionó ninguna etiqueta `biz_` |
| `401` | — | Falta la clave de API o no es válida |
| `403` | — | La clave de API no tiene el scope `identity:read` |
| `404` | `Account not found` | La etiqueta `biz_` no existe o no tienes acceso |


## Related topics

- [Verificación](https://docs.whop.com/es/api-reference/legacy/verifications/verification.md)
- [Verifica la identidad de los usuarios con KYC](https://docs.whop.com/es/developer/verification/overview.md)
- [Actualizar o eliminar una verificación](https://docs.whop.com/es/developer/verification/manage.md)
