Verifications

A verification represents one of multiple checks done by an individual. 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
InitiatedWhen the individual first starts the verification, the verification is initiated.
SubmittedWhen the individual submits their information, the server verifies their information.
PassedOnce the server has verified the individual's information, the verification passes.
FailedIf 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 confirmed status.

Verification StatusDescription
ConfirmedThe individual has verified that they have the physical device by entering a confirmation code. They have not submitted their information yet.

Government ID Verifications

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.

Persona IdentifierID Class Name
cctCitizen certificate
cidConsular ID
dlDriver license
hicHealthcare Insurance card
idNational ID
ippInternal passport
ltpassLong-Term pass card
midMilitary ID
mynMy Number card
nbiNBI card
nricNRIC
ofwOFW ID
panPAN card
pidPostal ID
ppPassport
ppcPassport card
prPermanent resident card
rpResidency permit
sssSocial Security ID
umidUMID
vidVoter ID
visaVisa
wpWork permit