---
title: "GET /largefacelists/{largeFaceListId}"
method: GET
path: "/largefacelists/{largeFaceListId}"
---

# GET /largefacelists/{largeFaceListId}

`GET /largefacelists/{largeFaceListId}`

Retrieve a Large Face List's largeFaceListId, name, userData and recognitionModel.

## Path parameters

- `largeFaceListId` string, required

## Query parameters

- `returnRecognitionModel` boolean

## Response `200`

A successful call returns the Large Face List's information.

- LargeFaceList — Large face list is a list of faces, up to 1,000,000 faces.
  - `name` string, required — User defined name, maximum length is 128.
  - `userData` string — Optional user defined data. Length should not exceed 16K.
  - `recognitionModel` 'recognition_01' | 'recognition_02' | 'recognition_03' | 'recognition_04' — The recognition model for the face.
  - `largeFaceListId` string, required

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** `e1f63ec9983b` — 1 info
  - api operation id `LargeFaceList_Get` removed and replaced with `FaceListOperations_GetLargeFaceList`

[Change history](https://skmtc.dev/azure/apis/ai-face/changes/largefacelists/:largeFaceListId/get.md)

---

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