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

# Identiteitsprofiel

> Een samengevoegd identiteits- of bedrijfsprofiel, gesynchroniseerd vanuit gegevens van de verificatieprovider.

```json Example theme={null}
{
	"business_address": {
		"city": "<string>",
		"country": "<string>",
		"line1": "<string>",
		"line2": "<string>",
		"postal_code": "<string>",
		"state": "<string>"
	},
	"business_name": "<string>",
	"business_structure": "<string>",
	"country": "<string>",
	"created_at": "2023-12-01T05:00:00.401Z",
	"date_of_birth": "<string>",
	"email": "<string>",
	"first_name": "<string>",
	"id": "idpf_xxxxxxxxxxxxx",
	"last_name": "<string>",
	"linked_companies": [
		{
			"id": "biz_xxxxxxxxxxxxxx",
			"title": "Pickaxe"
		}
	],
	"payout_status": "connected",
	"payouts_enabled": true,
	"personal_address": {
		"city": "<string>",
		"country": "<string>",
		"line1": "<string>",
		"line2": "<string>",
		"postal_code": "<string>",
		"state": "<string>"
	},
	"phone": "<string>",
	"profile_type": "<string>",
	"status": "not_started",
	"updated_at": "2023-12-01T05:00:00.401Z",
	"verifications": [
		{
			"created_at": "2023-12-01T05:00:00.401Z",
			"id": "verf_xxxxxxxxxxxxx",
			"last_error_code": "abandoned",
			"last_error_reason": "Document image was too blurry to read.",
			"session_url": "https://verify.stripe.com/session/abc123",
			"status": "requires_input"
		}
	]
}
```

**business\_address** `object | null` *required*

Geregistreerd bedrijfsadres zoals gerapporteerd door de identiteitsprovider. Aanwezig bij `business`-profielen.

**onderliggende attributen**

**city** `string | null` *required*

De plaats van het adres.

**country** `string | null` *required*

Het land van het adres.

**line1** `string | null` *required*

Regel 1 van het adres.

**line2** `string | null` *required*

Regel 2 van het adres.

**postal\_code** `string | null` *required*

De postcode van het adres.

**state** `string | null` *required*

De staat of provincie van het adres.

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

Naam van de bedrijfsentiteit. Aanwezig bij `business`-profielen.

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

Gerapporteerde rechtsvorm van een bedrijfsprofiel (bijv. `corp`, `llc`). Providerspecifieke waarden; aanwezig bij `business`-profielen.

**country** `string | null` *required*

ISO 3166-1 alpha-2-landcode zoals gerapporteerd door de identiteitsprovider, zoals `US` of `GB`. Voor personen is dit het land van nationaliteit of verblijf; voor bedrijven het land van oprichting.

**created\_at** `string\<date-time\>` *required*

Wanneer het identiteitsprofiel voor het eerst is aangemaakt.

Voorbeeld: `2023-12-01T05:00:00.401Z`

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

ISO-datum (`YYYY-MM-DD`) zoals gerapporteerd door de identiteitsprovider. Aanwezig bij `individual`-profielen.

**email** `string | null` *required*

E-mailadres zoals gerapporteerd door de identiteitsprovider. Doorgaans aanwezig bij `individual`-profielen.

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

Voornaam van de persoon.

**id** `string` *required*

De tag van het identiteitsprofiel (idpf\_xxx).

Voorbeeld: `idpf_xxxxxxxxxxxxx`

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

Achternaam van de persoon.

**linked\_companies** `array\<object\>` *required*

De bedrijven waaraan dit identiteitsprofiel momenteel is gekoppeld. Alleen gevuld bij directe Whop-gebruikerssessies; altijd leeg bij authenticatie via een API-sleutel, app of OAuth-scope (één identiteit kan gekoppeld zijn aan bedrijven die het aanroepende platform niet mag zien).

**onderliggende attributen**

**id** `string` *required*

De unieke identificatie van het bedrijf.

Voorbeeld: `biz_xxxxxxxxxxxxxx`

**title** `string` *required*

De weergavenaam van het bedrijf die aan klanten wordt getoond.

Voorbeeld: `Pickaxe`

**payout\_status** `PayoutAccountCalculatedStatuses` *required*

Voortgang van de inrichting van het uitbetalingsaccount voor dit profiel, los van blokkeringen. `connected` betekent dat de onboarding is voltooid; een `connected`-status in combinatie met `payouts_enabled: false` duidt op een actieve accountbeperking in plaats van een onvolledige inrichting.

Beschikbare opties: `connected`, `disabled`, `action_required`, `pending_verification`, `verification_failed`, `manual_review`, `denied`, `not_started`, `blocked_by_parent`

**payouts\_enabled** `boolean` *required*

Of dit profiel op dit moment uitbetalingen kan ontvangen. Alleen true wanneer de onboarding voor uitbetalingen is voltooid en er geen uitbetalingsblokkeringen actief zijn op het gekoppelde account. Beschouw dit als de enige bron van waarheid voor de gereedheid voor uitbetalingen.

**personal\_address** `object | null` *required*

Woonadres zoals gerapporteerd door de identiteitsprovider. Aanwezig bij `individual`-profielen.

**onderliggende attributen**

**city** `string | null` *required*

De plaats van het adres.

**country** `string | null` *required*

Het land van het adres.

**line1** `string | null` *required*

Regel 1 van het adres.

**line2** `string | null` *required*

Regel 2 van het adres.

**postal\_code** `string | null` *required*

De postcode van het adres.

**state** `string | null` *required*

De staat of provincie van het adres.

**phone** `string | null` *required*

Telefoonnummer zoals gerapporteerd door de identiteitsprovider. Doorgaans aanwezig bij `individual`-profielen.

**profile\_type** `string` *required*

Of dit een 'individual'- of 'business'-profiel is.

**status** `IdentityProfileStatuses` *required*

Afgeleide verificatiestatus over alle gekoppelde verificaties heen. Retourneert `action_required` zodra het profiel een openstaand verzoek om informatie heeft (of het nu een RFI voor verificatie, uitbetaling of audit is) — d.w\.z. de merchant moet iets indienen voordat het profiel in orde is.

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

**updated\_at** `string\<date-time\>` *required*

Wanneer het identiteitsprofiel voor het laatst is gesynchroniseerd vanuit een verificatie.

Voorbeeld: `2023-12-01T05:00:00.401Z`

**verifications** `array\<object\>` *required*

Alle verificatiepogingen die aan dit identiteitsprofiel zijn gekoppeld, de meest recente eerst.

**onderliggende attributen**

**created\_at** `string\<date-time\>` *required*

Wanneer het verificatierecord is aangemaakt.

Voorbeeld: `2023-12-01T05:00:00.401Z`

**id** `string` *required*

De numerieke id van het verificatierecord.

Voorbeeld: `verf_xxxxxxxxxxxxx`

**last\_error\_code** `VerificationErrorCodes | null` *required*

De meest recente foutcode die tijdens de verificatie is geretourneerd. Null als er geen fout is opgetreden.

Beschikbare opties: `abandoned`, `consent_declined`, `country_not_supported`, `device_not_supported`, `document_expired`, `document_type_not_supported`, `document_unverified_other`, `email_unverified_other`, `email_verification_declined`, `id_number_insufficient_document_data`, `id_number_mismatch`, `id_number_unverified_other`, `phone_unverified_other`, `phone_verification_declined`, `selfie_document_missing_photo`, `selfie_face_mismatch`, `selfie_manipulated`, `selfie_unverified_other`, `under_supported_age`

**last\_error\_reason** `string | null` *required*

Een voor mensen leesbare toelichting op de meest recente verificatiefout. Null als er geen fout is opgetreden.

Voorbeeld: `Document image was too blurry to read.`

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

Een URL die de gebruiker kan bezoeken om het verificatieproces te voltooien. Null als de sessie geen interactie van de gebruiker vereist.

Voorbeeld: `https://verify.stripe.com/session/abc123`

**status** `VerificationStatuses` *required*

De huidige status van deze verificatiesessie.

Beschikbare opties: `requires_input`, `processing`, `verified`, `canceled`, `created`, `started`, `submitted`, `approved`, `declined`, `resubmission_requested`, `expired`, `abandoned`, `review`, `action_required`, `manual_review`


## Related topics

- [Identityprofile updated](https://docs.whop.com/nl/api-reference/legacy/identity-profiles/identityprofile-updated.md)
- [Retrieve identity profile](https://docs.whop.com/nl/api-reference/legacy/identity-profiles/retrieve-identity-profile.md)
- [Unlink an identity profile](https://docs.whop.com/nl/api-reference/legacy/identity-profiles/unlink-an-identity-profile.md)
