> ## 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.

# PhilSys Biometric Match

> Verify identities using PhilSys Biometric Match, which performs liveness selfie matching against the Philippine Statistics Authority's national ID records.

export const VersionWarningBanner = () => {
  const [latestUrl, setLatestUrl] = useState(null);
  useEffect(() => {
    if (typeof window === "undefined") return;
    const {pathname, hash, search} = window.location;
    if (!pathname.includes("/go-v1/")) return;
    setLatestUrl(`${pathname.replace("/go-v1/", "/go-v2/")}${search}${hash}`);
  }, []);
  if (!latestUrl) return null;
  return <div className="not-prose my-6 rounded-xl border border-amber-500/30 bg-amber-500/10 px-4 py-3 text-sm text-gray-800 dark:text-gray-100">
      ⚠️ You are viewing the <strong>GBG GO v1</strong> documentation.
      <a href={latestUrl} className="ml-2 font-medium underline text-amber-700 dark:text-amber-400 hover:text-amber-800 dark:hover:text-amber-300">
        View version (v2) here →
      </a>
    </div>;
};

<VersionWarningBanner />

PhilSys Biometric Match is the Philippines' official electronic ID for accessing government services and verifying identity. Collects key personal data then performs a liveness selfie to match against the Philippine Statistics Authority’s national ID records covering 90 M+ citizens. To learn more, visit the [PhilSys Biometric Match website](https://philsys.gov.ph/ephilid/).

## Adoption data

This section provides insights into the adoption of PhilSys Biometric Match among users in the Philippines.

|                 |                                                                                                                                                                  |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Adoption        | 90 million                                                                                                                                                       |
| Adoption source | [https://philsys.gov.ph/90m-filipinos-now-registered-to-the-national-id-system/](https://philsys.gov.ph/90m-filipinos-now-registered-to-the-national-id-system/) |
| Adoption rate   | 98.77%                                                                                                                                                           |
| 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-philsys-match` |

## 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 PhilSys Biometric Match 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">dateOfBirth</Badge> | User’s date of birth |

### Sometimes returned attributes

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

| Field                                   | Description                          |
| --------------------------------------- | ------------------------------------ |
| <Badge color="green">middleName</Badge> | User’s middle name                   |
| <Badge color="gray">suffix</Badge>      | Name suffix (example; Jr., Sr., III) |

### Required input attributes

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

| Field                                     | Description                          |
| ----------------------------------------- | ------------------------------------ |
| <Badge color="green">firstName</Badge>    | Person’s first name                  |
| <Badge color="gray">middleName</Badge>    | Person’s middle name                 |
| <Badge color="yellow">lastNames</Badge>   | Person’s last name                   |
| <Badge color="purple">suffix</Badge>      | Name suffix (example; Jr., Sr., III) |
| <Badge color="orange">dateOfBirth</Badge> | Person’s date of birth               |
