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

> En Verification repræsenterer en juridisk identitet for en person eller virksomhed.

Konti og brugere gennemfører verifikation, når Whop skal bekræfte, hvem de er, før udbetalinger eller compliance-følsomme workflows aktiveres.

Brug Verifications API'et til at starte eller genoptage en hostet verifikationssession, kontrollere gennemgangsstatus og indsende anmodede oplysninger eller dokumenter. Hvis `requested_information` indeholder elementer, skal du indsende svar med [Opdatér verifikation](https://docs.whop.com/da/api-reference/verifications/update-verification.md).

> [!NOTE]
>
> Erstatter Legacy-ressourcen [Verifications](https://docs.whop.com/da/api-reference/verifications/verification).
> Eksisterende Legacy-integrationer fortsætter med at virke; se
> [API-versioner](https://docs.whop.com/da/developer/api/versioning.md) for stabilitetsaftalen.

## Endpoints

| Endpoint | Anmodning |
| - | - |
| [Vis verifikationer](https://docs.whop.com/da/api-reference/verifications/list-verifications.md) | GET `/verifications` |
| [Hent verifikation](https://docs.whop.com/da/api-reference/verifications/retrieve-verification.md) | GET `/verifications/{id}` |
| [Opret verifikation](https://docs.whop.com/da/api-reference/verifications/create-verification.md) | POST `/verifications` |
| [Opdatér verifikation](https://docs.whop.com/da/api-reference/verifications/update-verification.md) | PATCH `/verifications/{id}` |

## Attributter

**id** `string`

Verifikationsprofil-ID med præfikset `idpf_`.

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

Konti, som denne verifikation blev læst for, hver med præfikset `biz_`: den konto, du
listede efter, den konto eller underkonto, den tilhører med `include_subaccounts`,
eller alle konti, du kan læse, som den tilhører, når den hentes efter ID. Normalt
én. Tom for en personlig verifikation.

**address** `object | null`

Adresse på verifikationsprofilen. `null`, når ingen adresse er angivet.

> [accordion] Egenskaber
>
> **city** `string | null`
>
> **country** `string | null`
>
> Landekode på to bogstaver efter ISO 3166-1, for eksempel `US`, `DE` eller `GB`.
>
> **line1** `string`
>
> Første linje i gadeadressen.
>
> **line2** `string | null`
>
> Anden linje i gadeadressen.
>
> **postal\_code** `string | null`
>
> Postnummer.
>
> **state** `string | null`
>
> Kode for stat, provins eller region, for eksempel `CA`.

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

Virksomhedens juridiske navn.

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

Virksomhedens juridiske enhedsstruktur, såsom `private_corporation` eller
`sole_proprietorship`. Understøttede værdier varierer efter registreringsland — se
[Virksomhedsstrukturer](https://docs.whop.com/da/developer/verification/business-structures.md).

**country** `string | null`

Landekode på to bogstaver efter ISO 3166-1, for eksempel `US`, `DE` eller `GB`.

**created\_at** `string`

Hvornår verifikationsprofilen blev oprettet, som et ISO 8601-tidsstempel.

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

Formateret som `YYYY-MM-DD`.

**email** `string | null`

E-mailadresse på verifikationsprofilen.

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

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

Datoen, hvor virksomheden blev stiftet, formateret som `YYYY-MM-DD`, som registreret for
virksomhedsverifikationen. Kun virksomhedsverifikationer; `null`, indtil den er
sendt.

**kind** `string`

Tilgængelige muligheder: `individual`, `business`

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

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

Virksomhedens ejere og status for hver enkelts egen verifikation. Tom for individuelle verifikationer.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Ejer-ID med præfikset `own_`. Send det i Update Verifications `owners` for at ændre
> eller fjerne ejeren, inklusive en, der er tilføjet i den hostede session.
>
> **date\_of\_birth** `string | null` *required*
>
> Ejerens registrerede fødselsdato, formateret som `YYYY-MM-DD`.
>
> **first\_name** `string | null` *required*
>
> **last\_name** `string | null` *required*
>
> **ownership\_percentage** `number | null` *required*
>
> Andel af virksomheden, som personen ejer, fra 0 til 100.
>
> **rejected\_checks** `string[]` *required*
>
> Hvad udbyderen afviste, da ejerens verifikation blev sendt tilbage: `details` (personens navn, fødselsdato eller andre oplysninger stemmer ikke overens med ID'et), `identity_document` eller `selfie`. Ret kun disse med Update Verification. Ellers tom.
>
> Tilgængelige muligheder: `details`, `identity_document`, `selfie`
>
> **required\_documents** `object[]` *required*
>
> Ejerens dokumenter og deres status. Tom for en ejer, der er tilføjet med `verification_id`.
>
> > [accordion] Egenskaber
> >
> > **document** `string`
> >
> > Nøgle for dokumentplads, såsom `id_card_front`, `id_card_back` eller `selfie`.
> >
> > **rejection\_reason** `string | null`
> >
> > Hvorfor den tidligere indsendelse blev afvist, når udbyderen anmodede om nye
> > dokumenter eller afviste verifikationen.
> >
> > **status** `string`
> >
> > `pending_upload`, indtil dokumentet er videresendt til gennemgang; `submitted` derefter.
> >
> > Tilgængelige muligheder: `pending_upload`, `submitted`
>
> **roles** `string[]` *required*
>
> Hvad personen er for virksomheden.
>
> Tilgængelige muligheder: `ubo`, `director`, `representative`, `shareholder`
>
> **status** `string` *required*
>
> Status for ejerens egen verifikation, i de samme tilstande som `status`. `action_required`, når deres dokumenter skal sendes igen.
>
> Tilgængelige muligheder: `not_started`, `pending`, `processing`, `manual_review`, `approved`, `rejected`, `action_required`

**phone** `string | null`

Telefonnummer på verifikationsprofilen.

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

Stat eller region, hvor virksomheden er registreret, som registreret for
virksomhedsverifikationen. Kun virksomhedsverifikationer; `null`, indtil den er sendt.

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

Det nummer, virksomheden er registreret under på sit registreringssted, såsom
et state file number i USA eller et Company Number i Storbritannien. Kun
virksomhedsverifikationer; som registreret for virksomhedsverifikationen, eller `null`, indtil
den er sendt.

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

Hvad Whop stadig har brug for, før gennemgangen kan fortsætte, med ét krav pr. post. Svar med Update Verification. Intet fra svaret gentages tilbage. Nøgler, der ikke er relevante, udelades. For en virksomhedsverifikation, der er oprettet med `documents` eller `owners`, inkluderer dette de virksomhedsoplysninger og dokumenter, der stadig mangler, før den kan sendes til gennemgang. Hver ejers dokumenter vises under den pågældende ejer.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> ID for anmodet informationselement med præfikset `inrqi_`.
>
> **action\_url** `string`
>
> URL til en relateret handling, såsom at gennemføre liveness-verifikation eller se
> en betaling. Fraværende, når ingen handling er tilgængelig.
>
> **alternative\_document\_label** `string`
>
> Et dokument, der besvarer dette element i stedet for `value`, såsom et IRS
> EIN-brev, når EIN ikke kunne matches. Send dets sider i `files`, med eller
> uden en rettet `value`. Fraværende, når kun `value` accepteres.
>
> **details\_label** `string`
>
> Opfølgende prompt, der vises med dette krav.
>
> **details\_required** `boolean`
>
> Om det opfølgende svar er påkrævet, når det er synligt.
>
> **details\_visible\_for** `string[]`
>
> Valgte optionsværdier, der gør den opfølgende prompt synlig.
>
> **errors** `object[]`
>
> Til stede efter en afvist indsendelse.
>
> > [accordion] Egenskaber
> >
> > **code** `string`
> >
> > Stabil fejlkode.
> >
> > **reason** `string`
> >
> > Hvorfor det blev afvist.
>
> **label** `string` *required*
>
> Instruktion, der skal vises for brugeren. Indeholder korrekturlæserens note ordret, når der
> er en.
>
> **optional** `boolean`
>
> `true`, når elementet kan springes over.
>
> **options** `string[]`
>
> De værdier, `value` kan antage på et `select`-element. På et `id_document`-element er disse
> de accepterede ID-typer, og den valgte afgør, hvilke `documents`-pladser der
> skal sendes. Fraværende, når elementet ikke har noget valg.
>
> **requirement** `string` *required*
>
> Hvad der er brug for: et dokumentnavn såsom `bank_statement`, eller en feltnøgle såsom
> `ssn` eller `identity_document`. Håndtér ukendte værdier ud fra `type`.
>
> **response\_type** `string`
>
> Valgfrit native inputformat for et tekstsvar.
>
> Tilgængelige muligheder: `yes_no`, `yes_no_na`, `date`, `url`, `number`, `tel`
>
> **selection\_mode** `string`
>
> Om et spørgsmål med `options` accepterer én værdi eller flere værdier.
>
> Tilgængelige muligheder: `single`, `multiple`
>
> **supporting\_documents** `object[]`
>
> Dokumenter leveret med kravet som kontekst.
>
> > [accordion] Egenskaber
> >
> > **id** `string` *required*
> >
> > Filens ID med præfikset `file_`.
> >
> > **blurhash** `string | null` *required*
> >
> > BlurHash-pladsholder for et billede eller en video. Null, når den ikke er tilgængelig eller er fjernet
> > af moderering.
> >
> > **content\_type** `string | null` *required*
> >
> > Den oprindelige fils MIME-type, for eksempel `application/pdf`. Den bevares, når
> > moderering fjerner filen.
> >
> > **created\_at** `string` *required*
> >
> > Hvornår filen blev oprettet, som et ISO 8601-tidsstempel.
> >
> > **duration\_seconds** `number | null` *required*
> >
> > Lyd- eller videovarighed i sekunder. Null, når den ikke er tilgængelig eller er fjernet af
> > moderering.
> >
> > **filename** `string | null` *required*
> >
> > Det oprindelige filnavn, inklusive filtypenavnet.
> >
> > **height** `integer | null` *required*
> >
> > Billed- eller videohøjde i pixels. Null, når den ikke er tilgængelig eller er fjernet af
> > moderering.
> >
> > **multipart\_chunk\_size** `integer | null`
> >
> > Den bytestørrelse, hver del (undtagen den sidste) skal have. Kun til stede ved oprettelse, og
> > kun for multipart-uploads.
> >
> > **multipart\_upload\_id** `string | null`
> >
> > ID'et for multipart-uploadet, som sendes tilbage til `complete`. Kun til stede ved
> > oprettelse, og kun for multipart-uploads.
> >
> > **multipart\_upload\_urls** `object[] | null`
> >
> > Den presignede URL for hver del. Kun til stede ved oprettelse, og kun for multipart-uploads.
> >
> > > [accordion] Egenskaber
> > >
> > > **part\_number** `integer` *required*
> > >
> > > Det 1-baserede indeks for denne del i multipart-uploadet.
> > >
> > > **url** `string` *required*
> > >
> > > Den presignede URL, som denne dels bytes skal PUT'es til.
> >
> > **object** `string` *required*
> >
> > Typen af dette objekt, altid `file`.
> >
> > **removed\_by\_moderation** `boolean` *required*
> >
> > Om moderering har fjernet filen. Når `true`, leverer `url` et
> > erstatningsbillede. `filename`, `size` og `content_type` beskriver stadig den oprindelige fil.
> >
> > **size** `integer | null` *required*
> >
> > Filstørrelsen i bytes. `null`, indtil uploadet er færdigt.
> >
> > **upload\_headers** `object`
> >
> > Headers, der skal sendes med upload-PUT'en. Kun til stede ved oprettelse.
> >
> > **upload\_status** `string` *required*
> >
> > Hvor filen er i sin upload-livscyklus.
> >
> > Tilgængelige muligheder: `pending`, `processing`, `ready`, `failed`
> >
> > **upload\_url** `string | null`
> >
> > Presigned URL, som filens bytes skal PUT'es til. Kun til stede ved oprettelse, og kun for
> > uploads i én del.
> >
> > **url** `string | null` *required*
> >
> > En URL til at downloade filen. Offentlige filer får en permanent CDN-URL, og private
> > filer får en signeret URL, der udløber. `null`, indtil uploadet er færdigt.
> > Når moderering fjerner filen, en URL til et erstatningsbillede.
> >
> > **visibility** `string` *required*
> >
> > `public`-filer leveres fra en usigneret CDN-URL. `private`-filer leveres fra en signeret URL, der udløber.
> >
> > Tilgængelige muligheder: `public`, `private`
> >
> > **waveform\_url** `string | null` *required*
> >
> > URL til lydbølgeform. Null, når den ikke er tilgængelig eller er fjernet af moderering.
> >
> > **width** `integer | null` *required*
> >
> > Billed- eller videobredde i pixels. Null, når den ikke er tilgængelig eller er fjernet af moderering.
>
> **supporting\_files\_explanation\_allowed** `boolean`
>
> Om en skriftlig forklaring kan erstatte påkrævede understøttende filer.
>
> **supporting\_files\_required** `boolean`
>
> Om dette krav også har brug for understøttende filer.
>
> **supporting\_files\_visible\_for** `string[]`
>
> Valgte optionsværdier, der gør inputtet til understøttende filer synligt.
>
> **type** `string` *required*
>
> Hvad der skal sendes som svar, så du aldrig behøver at udlede det: `files` (et dokument, som en liste over dets sider), `id_document` (send `documents` med pladsnøglerne for det ID, du uploader), `text`, `date`, `phone` eller `select` (send `value`), `text_with_files` (send `value` og valgfrie `files`), `address` (send `address`) eller `liveness` (åbn `action_url`, og send derefter `value` som `true` efter gennemførelse).

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

Dokumenter til en verifikation via dokumentupload og deres status. Kun til stede på individuelle verifikationer, der er oprettet ved at sende `documents`. `pending_upload`-dokumenter er endnu ikke accepteret — send hele sættet igen med et nyt Create Verification-kald.

> [accordion] Egenskaber
>
> **document** `string`
>
> Nøgle for dokumentplads, såsom `id_card_front`, `id_card_back` eller `selfie`.
>
> **rejection\_reason** `string | null`
>
> Hvorfor den tidligere indsendelse blev afvist, når udbyderen anmodede om nye
> dokumenter eller afviste verifikationen.
>
> **status** `string`
>
> `pending_upload`, indtil dokumentet er videresendt til gennemgang; `submitted` derefter.
>
> Tilgængelige muligheder: `pending_upload`, `submitted`

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

URL til hostet verifikationssession, hvor brugeren gennemfører identitetskontroller.
Udløber 7 dage efter oprettelse.

**status** `string`

Aktuel verifikationstilstand. `not_started`, før der findes en session; `pending`, mens en session kræver brugerens input; `processing`, mens udbyderens automatiske kontroller kører på en ny indsendelse; `action_required`, når `requested_information` skal besvares; `manual_review`, mens allerede sendte oplysninger er under gennemgang — et revisionssvar eller et dokument, som udbetalingsudbyderen har — intet at indsende, normalt færdigt inden for 3 hverdage; `approved` ved succes; `rejected` ved fejl. Kald Create Verification igen for at starte en ny session.

Tilgængelige muligheder: `not_started`, `pending`, `processing`, `manual_review`, `approved`, `rejected`, `action_required`

**updated\_at** `string`

Hvornår verifikationsprofilen sidst blev opdateret, som et ISO 8601-tidsstempel.

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