> ## 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 de Verifications

> Una Verification representa la identidad legal de una persona o un negocio.

Las cuentas y los usuarios completan la verificación cuando Whop necesita confirmar su identidad antes de habilitar los pagos o los flujos de trabajo sensibles en materia de cumplimiento.

Usa la API de Verifications para iniciar o reanudar una sesión de verificación alojada, comprobar el estado de la revisión y enviar los datos o documentos solicitados. Si `requested_information` contiene elementos, envía las respuestas con [Actualizar verificación](https://docs.whop.com/es/api-reference/verifications/update-verification.md).

> [!NOTE]
>
> Sustituye al recurso Legacy [Verifications](https://docs.whop.com/es/api-reference/verifications/verification). Las integraciones Legacy existentes siguen funcionando; consulta [Versiones de la API](https://docs.whop.com/es/developer/api/versioning.md) para conocer el contrato de estabilidad.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar Verifications](https://docs.whop.com/es/api-reference/verifications/list-verifications.md) | GET `/verifications` |
| [Obtener Verification](https://docs.whop.com/es/api-reference/verifications/retrieve-verification.md) | GET `/verifications/{id}` |
| [Crear Verification](https://docs.whop.com/es/api-reference/verifications/create-verification.md) | POST `/verifications` |
| [Actualizar Verification](https://docs.whop.com/es/api-reference/verifications/update-verification.md) | PATCH `/verifications/{id}` |

## Atributos

**id** `string`

ID del perfil de verificación, con el prefijo `idpf_`.

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

Cuentas para las que se leyó esta verificación, cada una con el prefijo `biz_`: la cuenta por la que listaste, la cuenta o subcuenta a la que pertenece con `include_subaccounts`, o todas las cuentas que puedes leer a las que pertenece cuando se obtiene por ID. Normalmente una. Vacío para una verificación personal.

**address** `object | null`

Dirección del perfil de verificación. `null` cuando no se ha establecido ninguna dirección.

> [accordion] Propiedades
>
> **city** `string | null`
>
> **country** `string | null`
>
> Código de país ISO 3166-1 de dos letras, por ejemplo `US`, `DE` o `GB`.
>
> **line1** `string`
>
> Primera línea de la dirección.
>
> **line2** `string | null`
>
> Segunda línea de la dirección.
>
> **postal\_code** `string | null`
>
> Código postal.
>
> **state** `string | null`
>
> Código de estado, provincia o región, por ejemplo `CA`.

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

Razón social del negocio.

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

Estructura de entidad jurídica del negocio, como `private_corporation` o `sole_proprietorship`. Los valores admitidos varían según el país de constitución; consulta [Estructuras empresariales](https://docs.whop.com/es/developer/verification/business-structures.md).

**country** `string | null`

Código de país ISO 3166-1 de dos letras, por ejemplo `US`, `DE` o `GB`.

**created\_at** `string`

Cuándo se creó el perfil de verificación, como marca de tiempo ISO 8601.

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

Con el formato `YYYY-MM-DD`.

**email** `string | null`

Dirección de correo electrónico del perfil de verificación.

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

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

Fecha de constitución del negocio, con el formato `YYYY-MM-DD`, tal como consta en la verificación del negocio. Solo para verificaciones de negocios; `null` hasta que se envía.

**kind** `string`

Opciones disponibles: `individual`, `business`

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

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

Propietarios del negocio y el progreso de la verificación propia de cada uno. Vacío para verificaciones individuales.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID del propietario, con el prefijo `own_`. Envíalo en `owners` de Update Verification para cambiar o eliminar al propietario, incluido uno añadido en la sesión alojada.
>
> **date\_of\_birth** `string | null` *required*
>
> La fecha de nacimiento registrada del propietario, con el formato `YYYY-MM-DD`.
>
> **first\_name** `string | null` *required*
>
> **last\_name** `string | null` *required*
>
> **ownership\_percentage** `number | null` *required*
>
> Participación del negocio que posee la persona, de 0 a 100.
>
> **rejected\_checks** `string[]` *required*
>
> Lo que rechazó el proveedor cuando se devolvió la verificación del propietario: `details` (su nombre, fecha de nacimiento u otros datos no coinciden con su documento de identidad), `identity_document` o `selfie`. Corrige solo estos con Update Verification. Vacío en caso contrario.
>
> Opciones disponibles: `details`, `identity_document`, `selfie`
>
> **required\_documents** `object[]` *required*
>
> Los documentos del propietario y su progreso. Vacío para un propietario añadido con `verification_id`.
>
> > [accordion] Propiedades
> >
> > **document** `string`
> >
> > Clave del espacio del documento, como `id_card_front`, `id_card_back` o `selfie`.
> >
> > **rejection\_reason** `string | null`
> >
> > Por qué se rechazó el envío anterior, cuando el proveedor solicitó nuevos documentos o rechazó la verificación.
> >
> > **status** `string`
> >
> > `pending_upload` hasta que el documento se haya enviado para revisión; `submitted` después.
> >
> > Opciones disponibles: `pending_upload`, `submitted`
>
> **roles** `string[]` *required*
>
> Qué es la persona para el negocio.
>
> Opciones disponibles: `ubo`, `director`, `representative`, `shareholder`
>
> **status** `string` *required*
>
> El estado de la verificación propia del propietario, con los mismos estados que `status`. `action_required` cuando hay que volver a enviar sus documentos.
>
> Opciones disponibles: `not_started`, `pending`, `processing`, `manual_review`, `approved`, `rejected`, `action_required`

**phone** `string | null`

Número de teléfono del perfil de verificación.

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

Estado o región donde está constituido el negocio, tal como consta en la verificación del negocio. Solo para verificaciones de negocios; `null` hasta que se envía.

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

Número con el que se registró el negocio en su lugar de constitución, como un número de expediente estatal en EE. UU. o un Company Number en el Reino Unido. Solo para verificaciones de negocios; tal como consta en la verificación del negocio, o `null` hasta que se envía.

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

Lo que Whop aún necesita antes de que pueda continuar la revisión, con un requisito por entrada. Responde con Update Verification. No se devuelve nada de la respuesta. Se omiten las claves que no aplican. Para una verificación de negocio creada con `documents` u `owners`, esto incluye los datos del negocio y los documentos que aún faltan antes de poder enviarla a revisión. Los documentos de cada propietario se listan bajo ese propietario.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID del elemento de información solicitada, con el prefijo `inrqi_`.
>
> **action\_url** `string`
>
> URL de una acción relacionada, como completar la verificación de prueba de vida o ver un pago. Ausente cuando no hay ninguna acción disponible.
>
> **alternative\_document\_label** `string`
>
> Un documento que responde a este elemento en lugar de `value`, como una carta del IRS con el EIN cuando no se pudo verificar el EIN. Envía sus páginas en `files`, con o sin un `value` corregido. Ausente cuando solo se acepta `value`.
>
> **details\_label** `string`
>
> Pregunta de seguimiento que se muestra con este requisito.
>
> **details\_required** `boolean`
>
> Si la respuesta de seguimiento es obligatoria cuando está visible.
>
> **details\_visible\_for** `string[]`
>
> Valores de opción seleccionados que hacen visible la pregunta de seguimiento.
>
> **errors** `object[]`
>
> Presente después de un envío rechazado.
>
> > [accordion] Propiedades
> >
> > **code** `string`
> >
> > Código de error estable.
> >
> > **reason** `string`
> >
> > Por qué se rechazó.
>
> **label** `string` *required*
>
> Instrucción para mostrar al usuario. Incluye literalmente la nota del revisor cuando la hay.
>
> **optional** `boolean`
>
> `true` cuando el elemento se puede omitir.
>
> **options** `string[]`
>
> Los valores que puede tomar `value` en un elemento `select`. En un elemento `id_document` son los tipos de documento de identidad aceptados, y el elegido decide qué espacios de `documents` enviar. Ausente cuando el elemento no requiere elegir nada.
>
> **requirement** `string` *required*
>
> Lo que se necesita: un nombre de documento como `bank_statement`, o una clave de campo como `ssn` o `identity_document`. Gestiona los valores no reconocidos según `type`.
>
> **response\_type** `string`
>
> Formato de entrada nativo opcional para una respuesta de texto.
>
> Opciones disponibles: `yes_no`, `yes_no_na`, `date`, `url`, `number`, `tel`
>
> **selection\_mode** `string`
>
> Si una pregunta con `options` acepta un valor o varios valores.
>
> Opciones disponibles: `single`, `multiple`
>
> **supporting\_documents** `object[]`
>
> Documentos proporcionados con el requisito como contexto.
>
> > [accordion] Propiedades
> >
> > **id** `string` *required*
> >
> > El ID del archivo, con el prefijo `file_`.
> >
> > **blurhash** `string | null` *required*
> >
> > Marcador de posición BlurHash para una imagen o un vídeo. Null cuando no está disponible o la moderación lo ha eliminado.
> >
> > **content\_type** `string | null` *required*
> >
> > El tipo MIME del archivo original, por ejemplo `application/pdf`. Se conserva cuando la moderación elimina el archivo.
> >
> > **created\_at** `string` *required*
> >
> > Cuándo se creó el archivo, como marca de tiempo ISO 8601.
> >
> > **duration\_seconds** `number | null` *required*
> >
> > Duración del audio o del vídeo en segundos. Null cuando no está disponible o la moderación lo ha eliminado.
> >
> > **filename** `string | null` *required*
> >
> > El nombre de archivo original, incluida su extensión.
> >
> > **height** `integer | null` *required*
> >
> > Altura de la imagen o del vídeo en píxeles. Null cuando no está disponible o la moderación lo ha eliminado.
> >
> > **multipart\_chunk\_size** `integer | null`
> >
> > El tamaño en bytes que debe tener cada parte (excepto la última). Solo está presente al crear, y solo para cargas multiparte.
> >
> > **multipart\_upload\_id** `string | null`
> >
> > El ID de la carga multiparte, que se devuelve a `complete`. Solo está presente al crear, y solo para cargas multiparte.
> >
> > **multipart\_upload\_urls** `object[] | null`
> >
> > La URL prefirmada de cada parte. Solo está presente al crear, y solo para cargas multiparte.
> >
> > > [accordion] Propiedades
> > >
> > > **part\_number** `integer` *required*
> > >
> > > El índice, empezando por 1, de esta parte dentro de la carga multiparte.
> > >
> > > **url** `string` *required*
> > >
> > > La URL prefirmada a la que enviar con PUT los bytes de esta parte.
> >
> > **object** `string` *required*
> >
> > El tipo de este objeto, siempre `file`.
> >
> > **removed\_by\_moderation** `boolean` *required*
> >
> > Si la moderación eliminó el archivo. Cuando es `true`, `url` sirve una imagen de sustitución. `filename`, `size` y `content_type` siguen describiendo el archivo original.
> >
> > **size** `integer | null` *required*
> >
> > El tamaño del archivo en bytes. `null` hasta que la carga haya terminado.
> >
> > **upload\_headers** `object`
> >
> > Cabeceras que se deben enviar con el PUT de la carga. Solo está presente al crear.
> >
> > **upload\_status** `string` *required*
> >
> > En qué punto del ciclo de vida de la carga se encuentra el archivo.
> >
> > Opciones disponibles: `pending`, `processing`, `ready`, `failed`
> >
> > **upload\_url** `string | null`
> >
> > URL prefirmada a la que enviar con PUT los bytes del archivo. Solo está presente al crear, y solo para cargas de una sola parte.
> >
> > **url** `string | null` *required*
> >
> > Una URL para descargar el archivo. Los archivos públicos obtienen una URL de CDN permanente y los archivos privados obtienen una URL firmada que caduca. `null` hasta que la carga haya terminado. Cuando la moderación elimina el archivo, una URL de imagen de sustitución.
> >
> > **visibility** `string` *required*
> >
> > Los archivos `public` se sirven desde una URL de CDN sin firmar. Los archivos `private` se sirven desde una URL firmada que caduca.
> >
> > Opciones disponibles: `public`, `private`
> >
> > **waveform\_url** `string | null` *required*
> >
> > URL de la forma de onda del audio. Null cuando no está disponible o la moderación lo ha eliminado.
> >
> > **width** `integer | null` *required*
> >
> > Anchura de la imagen o del vídeo en píxeles. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **supporting\_files\_explanation\_allowed** `boolean`
>
> Si una explicación escrita puede sustituir a los archivos de soporte requeridos.
>
> **supporting\_files\_required** `boolean`
>
> Si este requisito también necesita archivos de soporte.
>
> **supporting\_files\_visible\_for** `string[]`
>
> Valores de opción seleccionados que hacen visible la entrada de archivos de soporte.
>
> **type** `string` *required*
>
> Qué enviar como respuesta, para que nunca tengas que deducirlo: `files` (un documento, como una lista de sus páginas), `id_document` (envía `documents` con las claves de espacio del documento de identidad que estás subiendo), `text`, `date`, `phone` o `select` (envía `value`), `text_with_files` (envía `value` y `files` opcionales), `address` (envía `address`) o `liveness` (abre `action_url` y luego envía `value` como `true` al completarla).

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

Documentos de una verificación por carga de documentos y su progreso. Solo presente en verificaciones individuales creadas enviando `documents`. Los documentos `pending_upload` aún no se aceptaron: vuelve a enviar el conjunto completo con otra llamada a Create Verification.

> [accordion] Propiedades
>
> **document** `string`
>
> Clave del espacio del documento, como `id_card_front`, `id_card_back` o `selfie`.
>
> **rejection\_reason** `string | null`
>
> Por qué se rechazó el envío anterior, cuando el proveedor solicitó nuevos documentos o rechazó la verificación.
>
> **status** `string`
>
> `pending_upload` hasta que el documento se haya enviado para revisión; `submitted` después.
>
> Opciones disponibles: `pending_upload`, `submitted`

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

URL de la sesión de verificación alojada para que el usuario complete las comprobaciones de identidad. Caduca 7 días después de su creación.

**status** `string`

Estado actual de la verificación. `not_started` antes de que exista una sesión; `pending` mientras una sesión necesita la intervención del usuario; `processing` mientras se ejecutan las comprobaciones automáticas del proveedor sobre un envío nuevo; `action_required` cuando `requested_information` necesita respuestas; `manual_review` mientras se revisa información ya enviada (una respuesta de auditoría o un documento que tiene el proveedor de pagos): no hay nada que enviar y normalmente se completa en 3 días hábiles; `approved` si tiene éxito; `rejected` si falla. Vuelve a llamar a Create Verification para iniciar una nueva sesión.

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

**updated\_at** `string`

Cuándo se actualizó el perfil de verificación por última vez, como marca de tiempo 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

- [Verifications](https://docs.whop.com/es/elements/latest/verifications/overview.md)
- [Estabilidad de la API](https://docs.whop.com/es/api-reference/stability.md)
- [API de Domains](https://docs.whop.com/es/api-reference/domains/domain.md)
