> For the complete documentation index, see [llms.txt](https://docs.vida.id/identity-stack/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vida.id/identity-stack/authentication/authentication-factors/biometric-device-selfie-id/integration-methods/face-match-api/api-reference.md).

# API Reference

FaceMatch API allows partners to verify a user’s identity by comparing a freshly captured selfie against a known image (template) without requiring credential provisioning.

| **API Name**               | **Description**                                                                                                                                                                               | **Method** | **Link**                                                                                                                                                                |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **FaceMatch - Initiation** | Starts the FaceMatch authentication process. Accepts a template image URL or `kyc_event_id` to initiate the comparison. Returns a session ID, bearer token, and follow-up URI.                | `GET`      | [View API](/identity-stack/authentication/authentication-factors/biometric-device-selfie-id/integration-methods/face-match-api/api-reference/transaction-initiation.md) |
| **FaceMatch - Completion** | Completes the FaceMatch process. The user submits a base64-encoded selfie image. The server compares it with the template image and responds with a JWT that includes the session identifier. | `POST`     | [View API](/identity-stack/authentication/authentication-factors/biometric-device-selfie-id/integration-methods/face-match-api/api-reference/transaction-completion.md) |