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

# Verifications API

> Een Verification vertegenwoordigt een juridische identiteit voor een persoon of onderneming.

Accounts en gebruikers voltooien een verificatie wanneer Whop moet bevestigen wie ze zijn voordat uitbetalingen of compliance-gevoelige workflows worden ingeschakeld.

Gebruik de Verifications API om een gehoste verificatiesessie te starten of te hervatten, de beoordelingsstatus te controleren en gevraagde gegevens of documenten in te dienen. Als `requested_information` items bevat, dien je de antwoorden in met [Update Verification](https://docs.whop.com/nl/api-reference/verifications/update-verification.md).

> [!NOTE]
>
> Vervangt de Legacy-resource [Verifications](https://docs.whop.com/nl/api-reference/verifications/verification). Bestaande Legacy-integraties blijven werken; zie [API-versies](https://docs.whop.com/nl/developer/api/versioning.md) voor de stabiliteitsafspraken.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Verifications opvragen](https://docs.whop.com/nl/api-reference/verifications/list-verifications.md) | GET `/verifications` |
| [Verification ophalen](https://docs.whop.com/nl/api-reference/verifications/retrieve-verification.md) | GET `/verifications/{id}` |
| [Verification aanmaken](https://docs.whop.com/nl/api-reference/verifications/create-verification.md) | POST `/verifications` |
| [Verification bijwerken](https://docs.whop.com/nl/api-reference/verifications/update-verification.md) | PATCH `/verifications/{id}` |

## Attributen

**id** `string`

Verificatieprofiel-ID, met prefix `idpf_`.

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

Accounts waarvoor deze verificatie is gelezen, elk met prefix `biz_`: het account waarop je hebt gefilterd, het account of subaccount waartoe deze behoort met `include_subaccounts`, of elk account dat je kunt lezen waartoe deze behoort wanneer opgehaald op ID. Meestal één. Leeg voor een persoonlijke verificatie.

**address** `object | null`

Adres op het verificatieprofiel. `null` wanneer er geen adres is ingesteld.

> [accordion] Eigenschappen
>
> **city** `string | null`
>
> **country** `string | null`
>
> Tweeletterige ISO 3166-1-landcode, bijvoorbeeld `US`, `DE` of `GB`.
>
> **line1** `string`
>
> Eerste regel van het straatadres.
>
> **line2** `string | null`
>
> Tweede regel van het straatadres.
>
> **postal\_code** `string | null`
>
> Postcode.
>
> **state** `string | null`
>
> Code van staat, provincie of regio, bijvoorbeeld `CA`.

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

Officiële bedrijfsnaam.

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

Rechtsvorm van de onderneming, zoals `private_corporation` of `sole_proprietorship`. Ondersteunde waarden verschillen per land van oprichting — zie [Bedrijfsstructuren](https://docs.whop.com/nl/developer/verification/business-structures.md).

**country** `string | null`

Tweeletterige ISO 3166-1-landcode, bijvoorbeeld `US`, `DE` of `GB`.

**created\_at** `string`

Wanneer het verificatieprofiel is aangemaakt, als ISO 8601-tijdstempel.

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

Opgemaakt als `YYYY-MM-DD`.

**email** `string | null`

E-mailadres op het verificatieprofiel.

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

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

Datum waarop de onderneming is opgericht, opgemaakt als `YYYY-MM-DD`, zoals vastgelegd voor de bedrijfsverificatie. Alleen bedrijfsverificaties; `null` totdat deze is verzonden.

**kind** `string`

Beschikbare opties: `individual`, `business`

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

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

Eigenaren van de onderneming en de voortgang van de eigen verificatie van elk van hen. Leeg voor individuele verificaties.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Eigenaar-ID, met prefix `own_`. Stuur deze mee in `owners` van Update Verification om de eigenaar te wijzigen of te verwijderen, inclusief een eigenaar die in de gehoste sessie is toegevoegd.
>
> **date\_of\_birth** `string | null` *required*
>
> De vastgelegde geboortedatum van de eigenaar, opgemaakt als `YYYY-MM-DD`.
>
> **first\_name** `string | null` *required*
>
> **last\_name** `string | null` *required*
>
> **ownership\_percentage** `number | null` *required*
>
> Aandeel in de onderneming dat de persoon bezit, van 0 tot 100.
>
> **rejected\_checks** `string[]` *required*
>
> Wat de provider heeft afgewezen toen de verificatie van de eigenaar werd teruggestuurd: `details` (naam, geboortedatum of andere gegevens komen niet overeen met het identiteitsbewijs), `identity_document` of `selfie`. Corrigeer alleen deze met Update Verification. Anders leeg.
>
> Beschikbare opties: `details`, `identity_document`, `selfie`
>
> **required\_documents** `object[]` *required*
>
> De documenten van de eigenaar en hun voortgang. Leeg voor een eigenaar die is toegevoegd met `verification_id`.
>
> > [accordion] Eigenschappen
> >
> > **document** `string`
> >
> > Sleutel van het documentslot, zoals `id_card_front`, `id_card_back` of `selfie`.
> >
> > **rejection\_reason** `string | null`
> >
> > Waarom de vorige inzending is afgewezen, wanneer de provider nieuwe documenten heeft gevraagd of de verificatie heeft afgewezen.
> >
> > **status** `string`
> >
> > `pending_upload` totdat het document voor beoordeling is doorgestuurd; daarna `submitted`.
> >
> > Beschikbare opties: `pending_upload`, `submitted`
>
> **roles** `string[]` *required*
>
> Wat de persoon voor de onderneming is.
>
> Beschikbare opties: `ubo`, `director`, `representative`, `shareholder`
>
> **status** `string` *required*
>
> De status van de eigen verificatie van de eigenaar, in dezelfde statussen als `status`. `action_required` wanneer de documenten opnieuw moeten worden verzonden.
>
> Beschikbare opties: `not_started`, `pending`, `processing`, `manual_review`, `approved`, `rejected`, `action_required`

**phone** `string | null`

Telefoonnummer op het verificatieprofiel.

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

Staat of regio waar de onderneming is opgericht, zoals vastgelegd voor de bedrijfsverificatie. Alleen bedrijfsverificaties; `null` totdat deze is verzonden.

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

Nummer waaronder de onderneming is geregistreerd op de plaats van oprichting, zoals een state file number in de VS of een Company Number in het VK. Alleen bedrijfsverificaties; zoals vastgelegd voor de bedrijfsverificatie, of `null` totdat deze is verzonden.

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

Wat Whop nog nodig heeft voordat de beoordeling kan doorgaan, met één vereiste per item. Beantwoord met Update Verification. Niets uit het antwoord wordt teruggegeven. Sleutels die niet van toepassing zijn, worden weggelaten. Voor een bedrijfsverificatie die is aangemaakt met `documents` of `owners` omvat dit de bedrijfsgegevens en documenten die nog ontbreken voordat deze ter beoordeling kan worden verzonden. De documenten van elke eigenaar worden onder die eigenaar vermeld.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> ID van het gevraagde informatie-item, met prefix `inrqi_`.
>
> **action\_url** `string`
>
> URL voor een gerelateerde actie, zoals het voltooien van een liveness-verificatie of het bekijken van een betaling. Afwezig wanneer er geen actie beschikbaar is.
>
> **alternative\_document\_label** `string`
>
> Een document dat dit item beantwoordt in plaats van `value`, zoals een IRS EIN-brief wanneer het EIN niet kon worden gematcht. Stuur de pagina's mee in `files`, met of zonder gecorrigeerde `value`. Afwezig wanneer alleen `value` wordt geaccepteerd.
>
> **details\_label** `string`
>
> Vervolgvraag die bij deze vereiste wordt getoond.
>
> **details\_required** `boolean`
>
> Of het vervolgantwoord verplicht is wanneer het zichtbaar is.
>
> **details\_visible\_for** `string[]`
>
> Geselecteerde optiewaarden die de vervolgvraag zichtbaar maken.
>
> **errors** `object[]`
>
> Aanwezig na een afgewezen inzending.
>
> > [accordion] Eigenschappen
> >
> > **code** `string`
> >
> > Stabiele foutcode.
> >
> > **reason** `string`
> >
> > Waarom het is afgewezen.
>
> **label** `string` *required*
>
> Instructie om aan de gebruiker te tonen. Bevat letterlijk de notitie van de beoordelaar wanneer die er is.
>
> **optional** `boolean`
>
> `true` wanneer het item kan worden overgeslagen.
>
> **options** `string[]`
>
> De waarden die `value` kan aannemen bij een `select`-item. Bij een `id_document`-item zijn dit de geaccepteerde typen identiteitsbewijs, en het gekozen type bepaalt welke `documents`-slots moeten worden verzonden. Afwezig wanneer er bij het item niets te kiezen valt.
>
> **requirement** `string` *required*
>
> Wat er nodig is: een documentnaam zoals `bank_statement`, of een veldsleutel zoals `ssn` of `identity_document`. Verwerk onbekende waarden op basis van `type`.
>
> **response\_type** `string`
>
> Optioneel native invoerformaat voor een tekstantwoord.
>
> Beschikbare opties: `yes_no`, `yes_no_na`, `date`, `url`, `number`, `tel`
>
> **selection\_mode** `string`
>
> Of een vraag met `options` één waarde of meerdere waarden accepteert.
>
> Beschikbare opties: `single`, `multiple`
>
> **supporting\_documents** `object[]`
>
> Documenten die ter context bij de vereiste worden geleverd.
>
> > [accordion] Eigenschappen
> >
> > **id** `string` *required*
> >
> > De ID van het bestand, met prefix `file_`.
> >
> > **blurhash** `string | null` *required*
> >
> > BlurHash-placeholder voor een afbeelding of video. Null wanneer niet beschikbaar of verwijderd door moderatie.
> >
> > **content\_type** `string | null` *required*
> >
> > Het MIME-type van het oorspronkelijke bestand, bijvoorbeeld `application/pdf`. Dit blijft behouden wanneer moderatie het bestand verwijdert.
> >
> > **created\_at** `string` *required*
> >
> > Wanneer het bestand is aangemaakt, als ISO 8601-tijdstempel.
> >
> > **duration\_seconds** `number | null` *required*
> >
> > Duur van audio of video in seconden. Null wanneer niet beschikbaar of verwijderd door moderatie.
> >
> > **filename** `string | null` *required*
> >
> > De oorspronkelijke bestandsnaam, inclusief extensie.
> >
> > **height** `integer | null` *required*
> >
> > Hoogte van afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.
> >
> > **multipart\_chunk\_size** `integer | null`
> >
> > De grootte in bytes die elk deel (behalve het laatste) moet hebben. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
> >
> > **multipart\_upload\_id** `string | null`
> >
> > De ID van de multipart-upload, die wordt teruggegeven aan `complete`. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
> >
> > **multipart\_upload\_urls** `object[] | null`
> >
> > De presigned URL voor elk deel. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
> >
> > > [accordion] Eigenschappen
> > >
> > > **part\_number** `integer` *required*
> > >
> > > De 1-gebaseerde index van dit deel binnen de multipart-upload.
> > >
> > > **url** `string` *required*
> > >
> > > De presigned URL waarnaar de bytes van dit deel met PUT moeten worden verzonden.
> >
> > **object** `string` *required*
> >
> > Het type van dit object, altijd `file`.
> >
> > **removed\_by\_moderation** `boolean` *required*
> >
> > Of moderatie het bestand heeft verwijderd. Wanneer `true`, levert `url` een vervangende afbeelding. `filename`, `size` en `content_type` beschrijven nog steeds het oorspronkelijke bestand.
> >
> > **size** `integer | null` *required*
> >
> > De bestandsgrootte in bytes. `null` totdat de upload is voltooid.
> >
> > **upload\_headers** `object`
> >
> > Headers om mee te sturen met de upload-PUT. Alleen aanwezig bij aanmaken.
> >
> > **upload\_status** `string` *required*
> >
> > Waar het bestand zich in de uploadlevenscyclus bevindt.
> >
> > Beschikbare opties: `pending`, `processing`, `ready`, `failed`
> >
> > **upload\_url** `string | null`
> >
> > Presigned URL waarnaar de bytes van het bestand met PUT moeten worden verzonden. Alleen aanwezig bij aanmaken, en alleen voor uploads in één deel.
> >
> > **url** `string | null` *required*
> >
> > Een URL om het bestand te downloaden. Openbare bestanden krijgen een permanente CDN-URL en privébestanden krijgen een ondertekende URL die verloopt. `null` totdat de upload is voltooid. Wanneer moderatie het bestand verwijdert, een URL van een vervangende afbeelding.
> >
> > **visibility** `string` *required*
> >
> > `public`-bestanden worden geleverd via een niet-ondertekende CDN-URL. `private`-bestanden worden geleverd via een ondertekende URL die verloopt.
> >
> > Beschikbare opties: `public`, `private`
> >
> > **waveform\_url** `string | null` *required*
> >
> > URL van de audiowaveform. Null wanneer niet beschikbaar of verwijderd door moderatie.
> >
> > **width** `integer | null` *required*
> >
> > Breedte van afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **supporting\_files\_explanation\_allowed** `boolean`
>
> Of een schriftelijke toelichting de vereiste ondersteunende bestanden mag vervangen.
>
> **supporting\_files\_required** `boolean`
>
> Of deze vereiste ook ondersteunende bestanden nodig heeft.
>
> **supporting\_files\_visible\_for** `string[]`
>
> Geselecteerde optiewaarden die het invoerveld voor ondersteunende bestanden zichtbaar maken.
>
> **type** `string` *required*
>
> Wat er als antwoord moet worden verzonden, zodat je het nooit hoeft af te leiden: `files` (een document, als lijst van pagina's), `id_document` (stuur `documents` met de slotsleutels voor het identiteitsbewijs dat je uploadt), `text`, `date`, `phone` of `select` (stuur `value`), `text_with_files` (stuur `value` en optioneel `files`), `address` (stuur `address`), of `liveness` (open `action_url` en stuur daarna `value` als `true` na voltooiing).

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

Documenten voor een verificatie via documentupload en hun voortgang. Alleen aanwezig bij individuele verificaties die zijn aangemaakt door `documents` te verzenden. `pending_upload`-documenten zijn nog niet geaccepteerd — stuur de volledige set opnieuw met een nieuwe Create Verification-aanroep.

> [accordion] Eigenschappen
>
> **document** `string`
>
> Sleutel van het documentslot, zoals `id_card_front`, `id_card_back` of `selfie`.
>
> **rejection\_reason** `string | null`
>
> Waarom de vorige inzending is afgewezen, wanneer de provider nieuwe documenten heeft gevraagd of de verificatie heeft afgewezen.
>
> **status** `string`
>
> `pending_upload` totdat het document voor beoordeling is doorgestuurd; daarna `submitted`.
>
> Beschikbare opties: `pending_upload`, `submitted`

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

URL van de gehoste verificatiesessie waarin de gebruiker de identiteitscontroles voltooit. Verloopt 7 dagen na aanmaak.

**status** `string`

Huidige verificatiestatus. `not_started` voordat er een sessie bestaat; `pending` zolang een sessie invoer van de gebruiker nodig heeft; `processing` terwijl de geautomatiseerde controles van de provider op een nieuwe inzending draaien; `action_required` wanneer `requested_information` antwoorden nodig heeft; `manual_review` terwijl al verzonden informatie wordt beoordeeld — een auditantwoord, of een document dat de uitbetalingsprovider aanhoudt — niets in te dienen, meestal binnen 3 werkdagen afgerond; `approved` bij succes; `rejected` bij mislukking. Roep Create Verification opnieuw aan om een nieuwe sessie te starten.

Beschikbare opties: `not_started`, `pending`, `processing`, `manual_review`, `approved`, `rejected`, `action_required`

**updated\_at** `string`

Wanneer het verificatieprofiel voor het laatst is bijgewerkt, als ISO 8601-tijdstempel.

```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/nl/elements/latest/verifications/overview.md)
- [Verification succeeded](https://docs.whop.com/nl/api-reference/legacy/verifications/verification-succeeded.md)
- [List verifications](https://docs.whop.com/nl/api-reference/legacy/verifications/list-verifications.md)
