---
title: "List all persons' information in the specified Person Group, including personId, name, userData and persistedFaceIds of registered person faces."
method: GET
path: "/persongroups/{personGroupId}/persons"
---

# List all persons' information in the specified Person Group, including personId, name, userData and persistedFaceIds of registered person faces.

`GET /persongroups/{personGroupId}/persons`

Persons are stored in alphabetical order of personId created in "Create Person Group Person".
>
*
  * "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

- `personGroupId` string, required

## Query parameters

- `start` string
- `top` integer

## Response `200`

A successful call returns an array of person information that belong to the Person Group.

- PersonGroupPerson[]
  - `personId` string, uuid, required — Universally Unique Identifier
  - `name` string, required — User defined name, maximum length is 128.
  - `userData` string — Optional user defined data. Length should not exceed 16K.
  - `persistedFaceIds` AzureCoreUuid[] — Face ids of registered faces in the person.

## 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)