DocumentationAPI Reference
DocumentationAPI Reference

Verifications

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.

Verification Status

Description

Initiated

When the individual first starts the verification, the verification is initiated.

Submitted

When the individual submits their information, the server verifies their information.

Passed

Once the server has verified the individual's information, the verification passes.

Failed

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 confirmed status.

Verification Status

Description

Confirmed

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

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 Identifier

ID Class Name

cct

Citizen certificate

cid

Consular ID

dl

Driver license

hic

Healthcare Insurance card

id

National ID

ipp

Internal passport

ltpass

Long-Term pass card

mid

Military ID

myn

My Number card

nbi

NBI card

nric

NRIC

ofw

OFW ID

pan

PAN card

pid

Postal ID

pp

Passport

ppc

Passport card

pr

Permanent resident card

rp

Residency permit

sss

Social Security ID

umid

UMID

vid

Voter ID

visa

Visa

wp

Work permit