requested_information contains items, submit answers with Update Verification.
Replaces the Legacy Verifications
resource. Existing Legacy integrations keep working; see API
versions for the stability contract.
Endpoints
Attributes
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.Address on the verification profile.
null when no address is set.Legal entity structure of the business, such as
private_corporation or
sole_proprietorship. Supported values vary by country of incorporation — see
Business structures.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.Owners of the business and the progress of each one’s own verification. Empty for individual verifications.
Properties
Properties
Owner ID, prefixed
own_. Send it in Update Verification’s owners to change
or remove the owner, including one added in the hosted session.What the provider rejected when the owner’s verification was sent back:
details (their name, date of birth, or other details don’t match their ID), identity_document, or selfie. Fix only these with Update Verification. Empty otherwise.Available options: details, identity_document, selfieThe owner’s documents and their progress. Empty for an owner added with
verification_id.Properties
Properties
Why the previous submission was rejected, when the provider requested new
documents or declined the verification.
What the person is to the business.Available options:
ubo, director, representative, shareholderState or region where the business is incorporated, as on file for the
business verification. Business verifications only;
null until it is sent.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.What Whop still needs before review can continue, with 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 business details and documents still missing before it can be sent for review. Each owner’s documents are listed under that owner.Properties
Properties
URL for a related action, such as completing liveness verification or viewing
a payment. Absent when no action is available.
A document that answers this item in place of
value, such as an IRS EIN
letter when the EIN could not be matched. Send its pages in files, with or
without a corrected value. Absent when only value is accepted.The values
value may take on a select item. On an id_document item these
are the ID types accepted, and the chosen one decides which documents slots
to send. Absent when the item has no choice to make.What is needed: a document name such as
bank_statement, or a field key such
as ssn or identity_document. Handle unrecognized values by type.Optional native input format for a text response.Available options:
yes_no, yes_no_na, date, url, number, telWhether a question with
options accepts one value or multiple values.Available options: single, multipleDocuments supplied with the requirement for context.
Properties
Properties
BlurHash placeholder for an image or video. Null when unavailable or removed
by moderation.
The original file’s MIME type, for example
application/pdf. It is kept when
moderation removes the file.Audio or video duration in seconds. Null when unavailable or removed by
moderation.
Image or video height in pixels. Null when unavailable or removed by
moderation.
The byte size each part (except the last) must be. Present only on create, and
only for multipart uploads.
The ID of the multipart upload, passed back to
complete. Present only on
create, and only for multipart uploads.Whether moderation removed the file. When
true, url serves a replacement
image. filename, size and content_type still describe the original file.Where the file is in its upload lifecycle.Available options:
pending, processing, ready, failedPresigned URL to PUT the file’s bytes to. Present only on create, and only for
single-part uploads.
A URL to download the file. Public files get a permanent CDN URL, and private
files get a signed URL that expires.
null until the upload has finished.
When moderation removes the file, a replacement image URL.public files are served from an unsigned CDN URL. private files are served from a signed URL that expires.Available options: public, privateWhat to send as the answer, so you never have to infer it:
files (a document, as a list of its pages), id_document (send documents with the slot keys for the ID you are uploading), text, date, phone or select (send value), text_with_files (send value and optional files), address (send address), or liveness (open action_url, then send value as true after completion).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.Properties
Properties
Why the previous submission was rejected, when the provider requested new
documents or declined the verification.
Hosted verification session URL for the user to complete identity checks.
Expires 7 days after creation.
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.Available options: not_started, pending, processing, manual_review, approved, rejected, action_requiredVerification

