Skip to main content

An identity verification session used to confirm a person or entity's identity for payout account eligibility.

​
id
string
required

The unique identifier for the verification.

Example:

"verf_xxxxxxxxxxxxx"

​
status
enum<string>
required

The current status of this verification session.

Available options:
requires_input,
processing,
verified,
canceled,
created,
started,
submitted,
approved,
declined,
resubmission_requested,
expired,
abandoned,
review
​
last_error_code
enum<string> | null
required

The most recent error code returned during verification. Null if no error has occurred.

Available options:
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

A human-readable explanation of the most recent verification error. Null if no error has occurred.

Example:

"Document image was too blurry to read."