---
title: "List faces' persistedFaceId and userData in a specified Large Face List."
method: GET
path: "/largefacelists/{largeFaceListId}/persistedfaces"
---

# List faces' persistedFaceId and userData in a specified Large Face List.

`GET /largefacelists/{largeFaceListId}/persistedfaces`

Faces are stored in alphabetical order of persistedFaceId created in "Add Large Face List Face".
>
*
  * "start" parameter (string, optional) specifies an ID value from which returned entries will have larger IDs based on string comparison. Setting "start" to an empty value indicates that entries should be returned starting from the first item.
  * "top" parameter (int, optional) determines the maximum number of entries to be returned, with a limit of up to 1000 entries per call. To retrieve additional entries beyond this limit, specify "start" with the personId of the last entry returned in the current call.

> [!TIP]
>
> * For example, there are total 5 items with their IDs: "itemId1", ..., "itemId5".
>   * "start=&top=" will return all 5 items.
>   * "start=&top=2" will return "itemId1", "itemId2".
>   * "start=itemId2&top=3" will return "itemId3", "itemId4", "itemId5".

## Path parameters

- `largeFaceListId` string, required

## Query parameters

- `start` string
- `top` integer

## Response `200`

A successful call returns an array of persisted faces and their information (persistedFaceId and userData).

- LargeFaceListFace[]
  - `persistedFaceId` string, uuid, required — Universally Unique Identifier
  - `userData` string — User-provided data attached to the face. The length limit is 1K.

## Other responses

- `default` — An unexpected error response.

---

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