curl --request POST \
--url https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/philippines/philsys-check-tier-1-passthrough \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"faceLivenessSessionId": "session-1001",
"pcn": "1234-5678-9012-3456"
}
'{
"success": true,
"message": "PhilSys Check Tier 1 processed successfully",
"data": {
"isValid": true,
"fullName": "JORDAN DELA SANTOS"
},
"verificationStatus": "VERIFIED",
"verificationStatusCode": 3,
"transactionId": "79b6f81c-fc48-42ce-b907-763129b0957e",
"verificationType": "philsys_check_tier_1",
"metadata": {
"yourRef": "case-1001"
},
"createdAt": "2026-09-01 08:00:00+0000"
}PhilSys Check Tier 1
Verify Philippine PhilSys. A successful combination of Philsys PCN and face will return the full name of the person.
curl --request POST \
--url https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/philippines/philsys-check-tier-1-passthrough \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"faceLivenessSessionId": "session-1001",
"pcn": "1234-5678-9012-3456"
}
'{
"success": true,
"message": "PhilSys Check Tier 1 processed successfully",
"data": {
"isValid": true,
"fullName": "JORDAN DELA SANTOS"
},
"verificationStatus": "VERIFIED",
"verificationStatusCode": 3,
"transactionId": "79b6f81c-fc48-42ce-b907-763129b0957e",
"verificationType": "philsys_check_tier_1",
"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 only full name of the person.Authorizations
Use your API token as a Bearer token in the Authorization header.
Headers
"Bearer {your_api_token}"
Body
- Option 1
- Option 2
- Option 3
Provide faceLivenessSessionId and exactly one of pcn, pcnFormData, or qrData.
ID of a current face-liveness session.
"session-1001"
Sixteen-digit PhilSys Card Number, with or without groups of four hyphenated digits.
^(?:\d{16}|\d{4}(?:-\d{4}){3})$"1234-5678-9012-3456"
Show child attributes
Show child attributes
Raw QR value from a supported ePhilID, PhilID, or Digital ID.
"PH1:sample-qr-value"
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. Additional source fields may be returned when available.
Show child attributes
Show child attributes
VERIFIED, REJECTED 3 = Verified, 1 = Rejected.
3, 1 "philsys_check_tier_1"
"2026-09-01 08:00:00+0000"