---
title: "Face match verification"
method: POST
path: "/verify/face_match"
tags: ["Face Match"]
---

# Face match verification

`POST /verify/face_match`

Compares two face images and returns a similarity score. Accepts `multipart/form-data` with either (`image1` file + `image2` file) or (`image1` file + `image2_url` string). Requires `X-API-KEY` and `X-Client-ID` headers.

## Response `200`

Face match result

- FaceMatchResponse
  - `status` string, required
  - `message` string, nullable
  - `error_code` string, nullable
  - `data` FaceMatchData
    - `is_match` boolean, nullable
    - `match_score` number, nullable
    - `confidence` string, nullable
    - `extras` object, nullable
  - `tranx_id` string, nullable
  - `timestamp` string, nullable

## Other responses

- `400` — Bad request — missing or invalid images.
- `401` — Unauthorized — missing or invalid API credentials.
- `500` — Internal server error.

---

[API](https://skmtc.dev/idto/apis/verification-api.md) · [All operations](https://skmtc.dev/idto/apis/verification-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idto/verification-api/revisions/e3d57dab8db4/schema)