Retrieve Verification
Retrieves a verification by ID, including its status and any information or documents still required.
Authorizations
An Account API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Headers
Pins the request to a dated API version.
"2026-11-04-1"
Path Parameters
Verification profile ID, prefixed idpf_.
Response
verification retrieved
Accounts this verification was read for, each prefixed biz_: the account you listed by, the account or subaccount it belongs to with include_subaccounts, or every account you can read that it belongs to when retrieved by ID. Usually one. Empty for a personal verification.
Owners of the business and the progress of each one's own verification. Empty for individual verifications.
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"
Date the business was incorporated, formatted as YYYY-MM-DD, as on file for the business verification. Business verifications only; null until it is sent.
"2021-03-15"
individual, business "individual"
"Webb"
Phone number on the verification profile.
"+15551234567"
State or region where the business is incorporated, as on file for the business verification. Business verifications only; null until it is sent.
"Delaware"
Number the business was registered under in its place of incorporation, such as a state file number in the US or a Company Number in the UK. Business verifications only; as on file for the business verification, or null until it is sent.
"7654321"
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. For a business verification created with documents or owners, this includes the company details and documents still missing before it can be sent for review; each owner's documents are listed under that owner.
Documents for a document-upload verification and their progress. Present only on individual 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"

