DocumentationAPI Reference
API ChangelogOpenAPI SpecStatus

Verifications

To verify a set of inputs from an individual, a Verification object is created. A Verification enables an Organization to answer “Is this person who they claim to be?” with a focus on verifying digital transactions. The verification process is accomplished through the generation and processing of Checks against the information provided by the individual.

The collective process of mixing and matching verifications to achieve sufficient assurance that an individual is indeed who they claim to be is often called identity proofing. The goal of identity proofing is often tying digital identities to physical identities.

An Inquiry contains one or more verifications. The attributes available for any given verification depends on its type. Each inquiry’s relationships field lists the IDs of all associated verifications. To authenticate when fetching photo URLs, pass the same Authorization header.

Verifications change statuses as the individual progresses through the flow. Check for the following statuses to monitor progress and find completed results.

Verification StatusDescription
InitiatedVerification has started, claimed information can now sent and saved to the server for verification
ConfirmedVerification has been confirmed. This is a status specific to PhoneNumber verifications where they have verified a confirmation code that was entered.
SubmittedVerification has been submitted, the claimed information is frozen and the server will process the verification
PassedVerification has passed. The required checks have passed and the information is verified
Requires RetryVerification requires a resubmission. The checks could not be fully processed due to issues with the submitted information
FailedVerification has failed. Some or all of the required checks have failed and verification has failed