Sign in
Verifications

Retrieve Verification

Returns verifications for an account, including their status and any required actions.

get/verifications/{verification_id}

Path parameters

verification_idstring required

Verification profile ID, prefixed idpf_.

Response

verification retrieved

business_namestring nullable

Legal business name.

business_structurestring nullable

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

countrystring nullable

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

created_atstring

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

date_of_birthstring nullable

Formatted as YYYY-MM-DD.

first_namestring nullable
idstring

Verification profile ID, prefixed idpf_.

kind'individual' | 'business'
last_namestring nullable
session_urlstring nullable

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

status'not_started' | 'pending' | 'processing' | 'approved' | 'rejected' | 'action_required'

Current verification state. not_started before any session has been created; pending while a session is in progress and needs the user's input; processing while the provider reviews submitted documents — nothing to do but wait; action_required when items in requested_information need answers before review can continue; approved once verification succeeds; rejected if it fails. Call the Create Verification endpoint again to start a new session.

updated_atstring

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

Changes