> ## 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 (QR Scan)

> Verify Philippine PhilSys records using QR scan data.

<CardGroup cols={1}>
  <Card title="Philsys API Help Page" href="https://docs.idmetagroup.com/resources/philsys-check-via-api">
    Verify Philippine PhilSys records using personal information.
  </Card>
</CardGroup>


## OpenAPI

````yaml api-reference-legacy/government-data/philippines/ph-philsys-check/ph-philsys-qr-scan.openapi.json POST /api/v1/verification/scan-qr
openapi: 3.0.3
info:
  title: IDmeta API - PH Philsys (QR Scan)
  version: 1.0.0
servers:
  - url: https://{environment-subdomain}.idmetagroup.com
    variables:
      environment-subdomain:
        default: integrate
security:
  - bearerAuth: []
paths:
  /api/v1/verification/scan-qr:
    post:
      tags:
        - Government Data
      summary: PH Philsys (QR Scan)
      description: Verify Philippine PhilSys records using QR scan data.
      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_value
                - template_id
                - verification_id
              properties:
                qr_value:
                  type: string
                  description: QR value string from the PhilSys QR payload.
                template_id:
                  type: integer
                  description: >-
                    Identifier used to categorize or group requests for tracking
                    or reporting.
                verification_id:
                  type: string
                  description: A unique ID used to identify your verification request.
            example:
              qr_value: '{...philsys qr value...}'
              template_id: '{your_trust_flow_id}'
              verification_id: '{your_created_verification_id}'
      responses:
        '200':
          description: PH Philsys QR scan verified successfully
          content:
            application/json:
              example:
                status: 3
                status_message: VERIFIED
                message: OK
                result: >-
                  {"data":{"code":"GMA1234","token":"123456789012345678901234567890123456","reference":"9876543210987654","face_url":"https://example-bucket.s3.ap-southeast-1.amazonaws.com/123/faces/9876543210987654.jpg","full_name":"JOHN
                  DOE","first_name":"JOHN","middle_name":"MICHAEL","last_name":"DOE","suffix":null,"gender":"Male","marital_status":"Married","blood_type":"O","email":"johndoe@example.com","mobile_number":"639123456789","birth_date":"1987-01-26","full_address":"123
                  FAKE STREET, SAMPLE BARANGAY, METRO MANILA, PHILIPPINES,
                  1000","address_line_1":"123 FAKE
                  STREET","address_line_2":null,"barangay":"Sample
                  Barangay","municipality":"Quezon City","province":"Metro
                  Manila","country":"Philippines","postal_code":"1000","present_full_address":"123
                  FAKE STREET, SAMPLE BARANGAY, METRO MANILA, PHILIPPINES,
                  1000","present_address_line_1":"123 FAKE
                  STREET","present_address_line_2":null,"present_barangay":"Sample
                  Barangay","present_municipality":"Quezon
                  City","present_province":"Metro
                  Manila","present_country":"Philippines","present_postal_code":"1000","residency_status":"Filipino","place_of_birth":"MAKATI
                  CITY","pob_municipality":"Makati","pob_province":"Metro
                  Manila","pob_country":"Philippines"},"meta":{"tier_level":"Tier
                  II","result_grade":1}}
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Use `Bearer {your_api_token}` in the Authorization header.

````