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.
Sandbox testing
Use sandbox mode with predetermined API payloads to retrieve every status this endpoint can return. Each payload is mapped to a specific outcome so you can confirm how your integration handles verified results.PhilSys Check Tier 2 sandbox payloads
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.
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"