> ## Documentation Index > Fetch the complete documentation index at: https://docs.idmetagroup.com/llms.txt > Use this file to discover all available pages before exploring further. # PH Philsys Tier 1 (QR Scan) > Verify Philippine PhilSys records using QR scan data. A successful combination of PhilSys QR data and face will return the full name of the person. PhilSys Check is a two-step process: capture face liveness, then call the verification API. Follow our integration guide for setup and workflow details. ## OpenAPI ````yaml api-reference/government-data/philippines/ph-philsys-check-tier-1/ph-philsys-qr-scan.openapi.json POST /api/v3/verifications/philippines/philsys-check-tier-1 openapi: 3.0.3 info: title: IDmeta API - PH Philsys Tier 1 (QR Scan) version: 1.0.0 servers: - url: https://{environment-subdomain}.idmetagroup.com variables: environment-subdomain: default: integrate security: - bearerAuth: [] paths: /api/v3/verifications/philippines/philsys-check-tier-1: post: tags: - Government Data summary: PH Philsys Tier 1 (QR Scan) description: >- Verify a Philippine PhilSys QR value together with a face-liveness session. Supported QR formats are ePhilID, PhilID, and Digital ID. A successful combination of PhilSys QR data and face will return the full name of the person. operationId: phPhilsysCheckTier1QrScanV3 parameters: - name: Accept in: header required: false schema: type: string default: application/json - name: Content-Type in: header required: false schema: type: string default: application/json requestBody: required: true content: application/json: schema: type: object required: - qr_data - face_liveness_session_id - trustFlowId - trustValidationId properties: qr_data: type: string description: PhilSys QR value for verification. face_liveness_session_id: type: string format: uuid description: Liveness session ID retrieved from the IDmeta Liveness SDK. trustFlowId: type: integer description: Identifier of the TrustFlow used for this verification. trustValidationId: type: string description: Unique ID of the Trust Validation being verified. example: qr_data: '{your scanned PhilSys QR value}' face_liveness_session_id: '{liveness session id retrieved from the IDmeta Liveness SDK}' trustFlowId: 0 trustValidationId: '{your_created_trust_validation_id}' responses: '200': description: PhilSys QR and face-liveness check processed successfully content: application/json: schema: $ref: '#/components/schemas/PhPhilsysCheckTier1Response' examples: Valid Philsys: summary: Valid PhilSys QR and face combination value: success: true message: PhilSys Tier 1 Check processed successfully data: isValid: true fullName: JUAN DELA CRUZ verificationStatus: VERIFIED verificationStatusCode: 3 trustFlowId: 0 trustValidationId: 9af6e3d7-09c8-489e-806e-d1e67a45a3e3 verificationType: philsys_check_tier_1 metadata: null Invalid Face and Philsys Combination: summary: >- QR was processed but the PhilSys and face combination was rejected value: success: true message: PhilSys Check Tier 1 processed successfully data: isValid: false reason: Invalid Face and PhilSys ID Combination verificationStatus: REJECTED verificationStatusCode: 1 trustFlowId: '427' trustValidationId: 8eee7132-a0a4-49c3-9f22-35a9ea42d5bf verificationType: philsys_check_tier_1 metadata: null createdAt: 2026-08-10 15:02:46+0000 Not Valid Philsys: summary: Not valid PhilSys QR value: success: true message: PhilSys Check Tier 1 processed successfully data: status: true isValid: false reason: Invalid PhilSys ID Information verificationStatus: REJECTED verificationStatusCode: 1 trustFlowId: '736' trustValidationId: a0160d0f-d0c3-4f58-b462-3b3e36c4ffff verificationType: philsys_check_tier_1 metadata: null createdAt: 2026-08-10 08:46:31+0000 '400': description: Validation failed or the liveness session has expired. content: application/json: examples: Validation failed: summary: Missing or invalid request fields value: success: false message: The face liveness session id field is required. errors: face_liveness_session_id: - The face liveness session id field is required. createdAt: 2026-09-21 08:00:00+0000 Invalid Digital ID: summary: Digital ID value does not meet the supported format value: success: false message: >- Digital ID must be alphanumeric and contain no more than 7 characters. errors: qr_data: >- Digital ID must be alphanumeric and contain no more than 7 characters. createdAt: 2026-09-21 08:00:00+0000 Expired Liveness Session: summary: The liveness session has expired value: success: false message: >- Liveness Sessions has Expired. Please perform liveness capturing again errors: face_liveness_session_id: - >- The Liveness Sessions has Expired. Please perform liveness capturing again createdAt: 2026-09-21 08:00:00+0000 '404': description: Trust Validation not found. content: application/json: example: success: false message: Trust Validation Not Found errors: trustValidation: Trust Validation Not Found createdAt: 2026-09-21 08:00:00+0000 '500': description: Upstream PhilSys server error or internal server error. content: application/json: examples: Upstream PhilSys server error: summary: PhilSys provider returned a server error value: success: false message: API call failed data: status: false response: '{"message":"Server Error"}' verificationStatus: FAILED verificationStatusCode: 6 trustFlowId: 0 trustValidationId: 9f8b1c2d-4e5a-4b6c-8d7e-1f2a3b4c5d6e verificationType: philsys_check_tier_1 metadata: null createdAt: 2026-08-25 06:14:22+0000 Internal server error: summary: Unhandled internal error value: success: false message: Internal Server Error createdAt: 2026-09-21 08:00:00+0000 components: schemas: PhPhilsysCheckTier1Response: type: object properties: success: type: boolean message: type: string data: type: object properties: isValid: type: boolean description: >- Always returned. Indicates whether the PhilSys Tier 1 check is valid. fullName: type: string description: >- Returned only when `isValid` is `true`. Omitted when `isValid` is `false`. reason: type: string description: >- Returned only when `isValid` is `false`. Explains why the PhilSys check was rejected. required: - isValid verificationStatus: type: string verificationStatusCode: type: integer trustFlowId: oneOf: - type: integer - type: string description: Trust flow ID (numeric or echoed identifier). trustValidationId: type: string format: uuid verificationType: type: string metadata: type: object nullable: true additionalProperties: true createdAt: type: string description: Timestamp when the verification result was created. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: Use `Bearer {your_api_token}` in the Authorization header. ````