---
title: "POST /identify"
method: POST
path: "/identify"
---

# POST /identify

`POST /identify`

1-to-many identification to find the closest matches of the specific query person face from a person group or large person group.

## Request body

- IdentifyRequest — Request body for identify face operation.
  - `faceIds` string[], required — Array of query faces faceIds, created by the Face - Detect. Each of the faces are identified independently. The valid number of faceIds is between [1, 10].
  - `personGroupId` string — PersonGroupId of the target person group, created by PersonGroup - Create. Parameter personGroupId and largePersonGroupId should not be provided at the same time.
  - `largePersonGroupId` string — LargePersonGroupId of the target large person group, created by LargePersonGroup - Create. Parameter personGroupId and largePersonGroupId should not be provided at the same time.
  - `maxNumOfCandidatesReturned` integer — The range of maxNumOfCandidatesReturned is between 1 and 5 (default is 1).
  - `confidenceThreshold` number — A number ranging from 0 to 1 indicating a level of confidence associated with a property.

## Response `200`

A successful call returns the identified candidate person(s) for each query face.

- IdentifyResult[]
  - `faceId` string, uuid, required — FaceId of the query face
  - `candidates` IdentifyCandidate[], required — Identified person candidates for that face (ranked by confidence). Array size should be no larger than input maxNumOfCandidatesReturned. If no person is identified, will return an empty array.
    - `personId` string, uuid, required — Id of candidate
    - `confidence` number, required — A number ranging from 0 to 1 indicating a level of confidence associated with a property.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.dev/azure/apis/cognitiveservices-face.md) · [All operations](https://skmtc.dev/azure/apis/cognitiveservices-face/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/cognitiveservices-face/revisions/dcdc115e9ae8/schema)