Create Identity Verification (API only flow)

Submit document images and a selfie photo directly to perform identity verification only with API (without the need to open hosted verification website). The caller uploads files via multipart/form-data.

Only the account itself or its parent account can create a verification session.

Primary vs Secondary IDs: Document types are classified as either primary or secondary. Primary IDs require only 1 document. Secondary IDs require 2 different secondary documents.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Government IDs are classified as Primary or Secondary (see Accepted IDs):

Primary IDs — only 1 document required:

DocumentEnum Value
Driver's Licensedriving_license_ph
Firearm Licensefirearm_license_ph
Foreign Passport (non-Philippine passport)other_passport
Passport (Philippine passport)passport
Philippine National ID (PhilSys/ePhilID)national_id_ph
PRC IDprc_id_ph
SSS IDsssid_ph
UMIDumid_ph

Secondary IDs — 2 different secondary documents required:

DocumentEnum Value
Alien Registration Cardalien_registration_card_ph
Barangay Clearancebarangay_clearance_ph
NBI Clearancenbi_clearance_ph
Pag-IBIG IDpag_ibig_ph
PhilHealth IDphilhealth_ph
Police Clearancepolice_clearance_ph
Postal IDpostal_id_ph
TIN IDtin_id
Voter's IDvoter_id_ph

When submitting a secondary ID as document_type, you must also provide a second, different secondary ID via secondary_document_type.

Listen for the result via a webhook event:

  • If the status passed: Proceed to the Update Account step.
  • If the verification failed or expired: Create a new identity verification session.
Path Params
string
required
^org_[a-zA-Z0-9]+$

Unique identifier for the account

Body Params
string
enum
required

Type of government-issued ID document. When a secondary ID is selected, a second different secondary document must be provided via secondary_document_type.

file
required

Front image of the ID document

file
required

Selfie photo for liveness check and face match

file

Back image of the ID document. Required for the following document types:
alien_registration_card_ph, driving_license_ph, national_id_ph, other_passport (signature page).
Optional for all other document types.

string
enum

Type of the second secondary ID document. Required when document_type is a secondary ID. Must be a secondary document type and must differ from document_type.

file

Front image of the second secondary ID document. Required when secondary_document_type is present.

file

Back image of the second secondary ID document. Required when secondary_document_type is alien_registration_card_ph.

Responses

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json