---
title: "Perform facial comparison"
method: POST
path: "/api/ai/images/v2/facial-comparison"
---

# Perform facial comparison

`POST /api/ai/images/v2/facial-comparison`

## Response `200`

Success

- ImageComparisonResponse
  - `id` string
  - `status` string
  - `timestamp` integer
  - `content` object
    - `matched_faces_count` integer
    - `unmatched_faces_count` integer
    - `matched_faces` MatchedFace[]
      - `similarity` number, float
      - `quality` FaceQuality
        - `brightness` number, float
        - `sharpness` number, float
      - `confidence` number, float
    - `unmatched_faces` UnmatchedFace[]
      - `confidence` number, float
      - `quality` FaceQuality
        - `brightness` number, float
        - `sharpness` number, float
  - `processing_count` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized - Invalid API Key or Organization Key
- `404` — Not Found
- `406` — Not Acceptable - Invalid Content Type or Content not supported
- `500` — Internal Server Error

---

[API](https://skmtc.net/worqhat/apis/worqhat-ai-api-endpoints.md) · [All operations](https://skmtc.net/worqhat/apis/worqhat-ai-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/worqhat/worqhat-ai-api-endpoints/revisions/a1044e79bd85/schema)