Retrieve Verification
Returns verifications for an account, including their status and any required actions.
Authorizations
An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.
Headers
Pins the request to a dated API version.
"2026-08-13"
Path Parameters
Verification profile ID, prefixed idpf_.
Response
verification retrieved
Address on the verification profile. null when no address is set.
Legal business name.
"Shine Time Auto Detailing, LLC"
Legal entity structure of the business, such as private_corporation or sole_proprietorship. Supported values vary by country of incorporation — see Business structures.
"sole_proprietorship"
Two-letter ISO 3166-1 country code, for example US, DE, or GB.
"US"
When the verification profile was created, as an ISO 8601 timestamp.
"2026-06-01T12:00:00.000Z"
Formatted as YYYY-MM-DD.
"1990-01-01"
Email address on the verification profile.
"marcus@shinetime.example"
"Marcus"
Verification profile ID, prefixed idpf_.
"idpf_xxxxxxxxxxxx"
individual, business "individual"
"Webb"
Phone number on the verification profile.
"+15551234567"
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.
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.
Hosted verification session URL for the user to complete identity checks. Expires 7 days after creation.
"https://sumsub.com/session/abc"
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.
not_started, pending, processing, manual_review, approved, rejected, action_required "action_required"
When the verification profile was last updated, as an ISO 8601 timestamp.
"2026-06-02T12:00:00.000Z"

