A verificationverification - A validation of the personal information submitted by an individual. represents one of multiple checks done by an individual. An inquiryinquiry - A single instance of an individual attempting to verify their identity. 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.
When the individual first starts the verification, the verification is initiated.
When the individual submits their information, the server verifies their information.
Once the server has verified the individual's information, the verification passes.
If the server fails to verify the individual's information, the verification fails.
All verifications operate with the above statuses, except for the phone number verification which additionally uses a
The individual has verified that they have the physical device by entering a confirmation code. They have not submitted their information yet.
Government ID verifications have an
id-class attribute. This is the type of ID associated with the verification. The following are the Persona ID class identifiers. Please note that some of these ID types are only relevant to certain locales, and so may not be relevant to all use cases.
ID Class Name
Healthcare Insurance card
Long-Term pass card
My Number card
Permanent resident card
Social Security ID