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

# GET /largefacelists/{largeFaceListId}/persistedfaces

`GET /largefacelists/{largeFaceListId}/persistedfaces`

List all faces in a large face list, and retrieve face information (including userData and persistedFaceIds of registered faces of the face).

## Path parameters

- `largeFaceListId` string, required

## Query parameters

- `start` string
- `top` integer

## Response `200`

A successful call returns an array of face information that belong to the large face list.

- PersistedFace[] — An array of persisted faces within the face list or large face list.
  - `persistedFaceId` string, uuid, required — The persistedFaceId of the target face, which is persisted and will not expire. Different from faceId created by Face - Detect and will expire in at the time specified by faceIdTimeToLive after the detection call.
  - `userData` string — User-provided data attached to the face. The size limit is 1KB.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/azure/apis/cognitiveservices-face.md) · [All operations](https://skmtc.net/azure/apis/cognitiveservices-face/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/cognitiveservices-face/versions/8a19b734b92a/schema)