---
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 object.
  - `largeFaceListId` string, required — LargeFaceListId of the target large face list.
  - `name` string, required — User defined name, maximum length is 128.
  - `userData` string — User specified data. Length should not exceed 16KB.
  - `recognitionModel` 'recognition_01' | 'recognition_02' | 'recognition_03' | 'recognition_04' — Name of recognition model. Recognition model is used when the face features are extracted and associated with detected faceIds, (Large)FaceList or (Large)PersonGroup. A recognition model name can be provided when performing Face - Detect or (Large)FaceList - Create or (Large)PersonGroup - Create. The default value is 'recognition_01', if latest model needed, please explicitly specify the model you need.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/azure/apis/face-client.md) · [All operations](https://skmtc.net/azure/apis/face-client/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/face-client/revisions/106051bfd7b7/schema)