Verification

A Verification represents a legal identity for a person or business. Accounts and users complete verification when Whop needs to confirm who they are before enabling payouts or compliance-sensitive workflows.

Use the Verifications API to start or resume a hosted verification session, check review status, and submit requested details or documents. If requested_information contains items, submit answers with Update Verification.

Replaces the Legacy Verifications resource. Existing Legacy integrations keep working; see API versions for the stability contract.

Endpoints

Endpoint	Request
List Verifications	GET /verifications
Create Verification	POST /verifications
Retrieve Verification	GET /verifications/{id}
Update Verification	PATCH /verifications/{id}

Attributes

id · string

Verification profile ID, prefixed idpf_.

address · object | null

Address on the verification profile. null when no address is set.

Properties

city · string | null

country · string | null

Two-letter ISO 3166-1 country code, for example US, DE, or GB.

line1 · string

First line of the street address.

line2 · string | null

Second line of the street address.

postal_code · string | null

Postal or ZIP code.

state · string | null

State, province, or region code, for example CA.

business_name · string | null

Legal business name.

business_structure · string | null

Legal entity structure of the business, such as private_corporation or sole_proprietorship. Supported values vary by country of incorporation — see Business structures.

country · string | null

Two-letter ISO 3166-1 country code, for example US, DE, or GB.

created_at · string

When the verification profile was created, as an ISO 8601 timestamp.

date_of_birth · string | null

Formatted as YYYY-MM-DD.

email · string | null

Email address on the verification profile.

first_name · string | null

kind · string

Available options: individual, business

last_name · string | null

phone · string | null

Phone number on the verification profile.

requested_information · object[]

What Whop still needs before review can continue — one requirement per entry. Answer with Update Verification; nothing from the response is echoed back. Keys that don’t apply are omitted.

Properties

id · string · required

Requested information item ID, prefixed inrqi_.

errors · object[]

Present after a rejected submission.

Properties

code · string

Stable error code.

reason · string

Why it was rejected.

label · string · required

Instruction to show the user. Carries the reviewer’s note verbatim when there is one.

optional · boolean

true when the item can be skipped.

options · string[]

The values value may take on a select item. On an id_document item these are the ID types accepted, and the chosen one decides which documents slots to send. Absent when the item has no choice to make.

requirement · string · required

What is needed: a document name such as bank_statement, or a field key such as ssn or identity_document. Handle unrecognized values by type.

type · string · required

What to send as the answer, so you never have to infer it: files (a document, as a list of its pages), id_document (send documents with the slot keys for the ID you are uploading), text, date, phone or select (send value), or address (send address).

required_documents · object[]

Documents for a document-upload verification and their progress. Present only on verifications created by sending documents. pending_upload documents were not accepted yet — send the full set again with another Create Verification call.

Properties

document · string

Document slot key, such as id_card_front, id_card_back, or selfie.

rejection_reason · string | null

Why the previous submission was rejected, when the provider requested new documents or declined the verification.

status · string

pending_upload until the document has been relayed for review; submitted afterwards.

Available options: pending_upload, submitted

session_url · string | null

Hosted verification session URL for the user to complete identity checks. Expires 7 days after creation.

status · string

Current verification state. not_started before any session exists; pending while a session needs the user’s input; processing while the provider’s automated checks run on a fresh submission; action_required when requested_information needs answers; manual_review while information already sent is under review — an audit answer, or a document the payout provider holds — nothing to submit, usually done within 3 business days; approved on success; rejected on failure. Call Create Verification again to start a new session.

Available options: not_started, pending, processing, manual_review, approved, rejected, action_required

updated_at · string

When the verification profile was last updated, as an ISO 8601 timestamp.

Verification

{
	"id": "idpf_xxxxxxxxxxxx",
	"address": {
		"city": "New York",
		"country": "US",
		"line1": "123 Spring Street",
		"line2": "Apt 4B",
		"postal_code": "10012",
		"state": "NY"
	},
	"business_name": null,
	"business_structure": null,
	"country": "US",
	"created_at": "2026-06-01T12:00:00Z",
	"date_of_birth": "1990-01-01",
	"email": "[e-mail]",
	"first_name": "Alex",
	"kind": "individual",
	"last_name": "Rivera",
	"phone": "[phone]",
	"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"
}