---
title: "Get a similarity score for two faces"
method: POST
path: "/compare-faces"
---

# Get a similarity score for two faces

`POST /compare-faces`

The minimum recommended face size in the picture is **80 pixels**. If the face size is between **65-79 pixels**, an error code will be returned along with the similarity score.

**Parameters:**

-   `companyKey` (string, required) - The company's secret key.
-   `face1` _(file, required)_ - A JPEG or PDF file for face1
-   `face2` _(file, required)_ - A JPEG or PDF file for face2

## Request body

- CompareFaces
  - `companyKey` string
  - `face1` object
    - `contentType` string
  - `face2` object
    - `contentType` string

## Response `200`

Success

- CompareFacesResponse
  - `result` object
    - `similarity` number
    - `face1Statuses` unknown[]
      - unknown
    - `face2Statuses` unknown[]
      - unknown

---

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