> ## Documentation Index
> Fetch the complete documentation index at: https://docs.go.gbgplc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ePhilID

> Verify identities using ePhilID, the Philippines' official electronic ID with QR-based verification against the PhilSys national registry.

The Philippines' official electronic ID for accessing government services and verifying identity. It is a government-issued printed card with a QR on the back that can be verified against the government source (PhilSys), optionally with a liveness/biometric check hosted by PhilSys. To learn more, visit the [ePhilID website](https://philsys.gov.ph/ephilid/).

## Adoption data

This section provides insights into the adoption of ePhilID among users in the Philippines.

|                 |                                                     |
| --------------- | --------------------------------------------------- |
| Adoption        | 47 million                                          |
| Adoption source | [https://philsys.gov.ph/](https://philsys.gov.ph/)  |
| Adoption rate   | 51.58%                                              |
| Coverage        | 91M                                                 |
| Status          | <Badge color="gray">In Integration Pipeline</Badge> |

## Provider ID

This is the unique identifier for this digital ID provider in the GBG GO system.

|             |                                      |
| ----------- | ------------------------------------ |
| Provider ID | `philippines-digital-national-id-qr` |

## Compliance

This section outlines compliance and regulatory requirements for integrating this digital ID provider.

| Compliance data           | Status                             |
| ------------------------- | ---------------------------------- |
| Locality requirements     | <Badge color="green">None</Badge>  |
| Scheme-level restrictions | <Badge color="yellow">None</Badge> |
| Certifications            | <Badge color="gray">None</Badge>   |

## Supported attributes

The following attributes are returned when ePhilID is used for identity verification:

### Always returned attributes

The following attributes are always returned from a successful verification from this ID Provider.

| Field                                                 | Description                      |
| ----------------------------------------------------- | -------------------------------- |
| <Badge color="green">firstName</Badge>                | User’s first name                |
| <Badge color="gray">lastNames</Badge>                 | User’s last name                 |
| <Badge color="yellow">middleName</Badge>              | User’s middle name               |
| <Badge color="purple">dateOfBirth</Badge>             | User’s date of birth             |
| <Badge color="orange">sex</Badge>                     | User’s gender                    |
| <Badge color="green">type</Badge>                     | Type of identity document        |
| <Badge color="gray">document issueDate</Badge>        | Document issue date              |
| <Badge color="yellow">document issuingCountry</Badge> | Country that issued the document |

### Sometimes returned attributes

The following attributes are sometimes returned from a successful verification from this ID Provider.

| Field                                                     | Description                                |
| --------------------------------------------------------- | ------------------------------------------ |
| <Badge color="green">suffix</Badge>                       | Name suffix (example; Jr., Sr., III)       |
| <Badge color="gray"> attachments documentPortrait</Badge> | Portrait image extracted from the document |

### Required input attributes

The following attributes are required as input to perform identity verification with this ID Provider.

| Field                                   | Description                      |
| --------------------------------------- | -------------------------------- |
| <Badge color="green">qrCodeText</Badge> | Text data encoded in the QR code |
| <Badge color="gray">qrCodeImage</Badge> | Image of the QR code             |