Skip to main content
A Verification represents an identity review for an account that needs to receive payouts or satisfy compliance requirements. It tracks the verification status and the latest provider error when more information is needed. Use the Verifications API to create a verification session, list or retrieve verification status, update submitted identity details, and delete a verification when it should no longer be used.

​
Endpoints

EndpointRequest
List VerificationsGET /verifications
Create VerificationPOST /verifications
Retrieve VerificationGET /verifications/{verification_id}
Update VerificationPATCH /verifications/{verification_id}
Delete VerificationDELETE /verifications/{verification_id}

​
Attributes

​
address
object | null
​
business_name
string | null
​
business_structure
string | null
​
country
string | null
ISO 3166-1 alpha-2 country code (e.g. US, GB). For individuals this is the country of citizenship or residence reported by the identity provider; for businesses this is the country of incorporation.
​
created_at
string
​
date_of_birth
string | null
​
first_name
string | null
​
id
string
The verification ID, e.g. idpf_*
​
kind
string
Available options: individual, business
​
last_name
string | null
​
requested_information
object[]
The outstanding information this verification still needs — payout RFIs and audit RMIs, one uniform shape.

Properties

​
description
string | null
Additional guidance for the field beyond the label.
​
error_message
string | null
The reason a previously submitted value was rejected, or null.
​
field
string
Stable snake_case key for the field (e.g. ssn, business_description).
​
id
string
The requested information item id (inrqi_*). Use this when answering.
​
label
string
Human-readable label for the field (e.g. “Social Security Number”).
​
requested_files
object[]
Upload slots for a files item — always at least one when type is files, empty otherwise.

Properties

​
category
string | null
Identifier to send back with the uploaded file so it routes correctly; null for a generic upload.
​
is_optional
boolean
Whether this slot can be left empty.
​
kind
string | null
Provider-specific document kind, when applicable.
​
label
string
Label for this upload slot (e.g. “Front of ID Document”).
​
multiple
boolean
Whether this slot accepts more than one file.
​
type
string | null
How to render the input: text, date, phone, address, or files.
​
session_url
string | null
​
status
string
Available options: not_started, pending, approved, rejected, action_required
​
updated_at
string
Verification
{
	"address": {
		"city": "New York",
		"country": "US",
		"line1": "123 Spring Street",
		"postal_code": "10012",
		"region": "NY"
	},
	"business_name": null,
	"business_structure": null,
	"country": "US",
	"created_at": "2026-06-01T12:00:00Z",
	"date_of_birth": "1990-01-01",
	"first_name": "Alex",
	"id": "idpf_xxxxxxxxxxxx",
	"kind": "individual",
	"last_name": "Rivera",
	"requested_information": [
		{
			"description": "A government-issued photo ID used to confirm your identity.",
			"error_message": null,
			"field": "identity_document",
			"id": "inrqi_xxxxxxxxxxx",
			"label": "Identity Document",
			"requested_files": [
				{
					"category": "identity_document_front",
					"is_optional": false,
					"kind": null,
					"label": "Front of ID Document",
					"multiple": false
				},
				{
					"category": "identity_document_back",
					"is_optional": false,
					"kind": null,
					"label": "Back of ID Document",
					"multiple": false
				}
			],
			"type": "files"
		}
	],
	"session_url": "https://verify.whop.com/session/idpf_xxxxxxxxxxxx",
	"status": "action_required",
	"updated_at": "2026-06-02T12:00:00Z"
}