curl --request POST \
--url https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/philippines/philsys-check-passthrough \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"faceLivenessSessionId": "session-1001",
"pcn": "1234-5678-9012-3456"
}
'{
"success": true,
"message": "PhilSys Check processed successfully",
"data": {
"isValid": true,
"fullName": "JORDAN DELA SANTOS",
"firstName": "JORDAN",
"middleName": "DELA",
"lastName": "SANTOS",
"birthDate": "1990-02-01"
},
"verificationStatus": "VERIFIED",
"verificationStatusCode": 3,
"transactionId": "79b6f81c-fc48-42ce-b907-763129b0957e",
"verificationType": "philsys-check-tier-2",
"metadata": {
"yourRef": "case-1001"
},
"createdAt": "2026-09-01 08:00:00+0000"
}PhilSys Check Tier 2
Verify Philippine PhilSys records using PCN. A successful combination of Philsys PCN and face will return a full profile of the person including their full name, registered address, potrait image, and other details.
curl --request POST \
--url https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/philippines/philsys-check-passthrough \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"faceLivenessSessionId": "session-1001",
"pcn": "1234-5678-9012-3456"
}
'{
"success": true,
"message": "PhilSys Check processed successfully",
"data": {
"isValid": true,
"fullName": "JORDAN DELA SANTOS",
"firstName": "JORDAN",
"middleName": "DELA",
"lastName": "SANTOS",
"birthDate": "1990-02-01"
},
"verificationStatus": "VERIFIED",
"verificationStatusCode": 3,
"transactionId": "79b6f81c-fc48-42ce-b907-763129b0957e",
"verificationType": "philsys-check-tier-2",
"metadata": {
"yourRef": "case-1001"
},
"createdAt": "2026-09-01 08:00:00+0000"
}faceLivenessSessionId plus exactly one of pcn, pcnFormData, or qrData. Supported QR formats are ePhilID, PhilID, and Digital ID. Unknown QR formats fail validation.
When PhilSys information is matched and validated with the faceLivenessSessionId, the API returns full personal information.
A completed rejection still returns HTTP 200, success: true, and the top-level processed-successfully message. Check data.isValid for the outcome and read data.reason when it is false.Authorizations
Use your API token as a Bearer token in the Authorization header.
Headers
"Bearer {your_api_token}"
Body
- By PCN
- By Personal Information
- By QR
Provide faceLivenessSessionId and exactly one of pcn, pcnFormData, or qrData.
Sixteen-digit PhilSys Card Number, with or without groups of four hyphenated digits.
^(?:\d{16}|\d{4}(?:-\d{4}){3})$"1234-5678-9012-3456"
ID of a current face-liveness session.
"session-1001"
Optional key-value pairs echoed back in completed and source-error responses.
Response
Request processed. Check data.isValid and verificationStatus to determine the outcome. For a rejected result, data.reason explains why the PhilSys verification was invalid.
true
CamelCase result fields for this verification type. When PhilSys information is matched and validated with the faceLivenessSessionId, additional source fields with full personal information are returned.
Show child attributes
Show child attributes
VERIFIED, REJECTED 3 = Verified, 1 = Rejected.
3, 1 "philsys-check-tier-2"
"2026-09-01 08:00:00+0000"