---
title: "List all persons' information in Person Directory, including personId, name, and userData."
method: GET
path: "/persons"
---

# List all persons' information in Person Directory, including personId, name, and userData.

`GET /persons`

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

## Query parameters

- `start` string
- `top` integer

## Response `200`

A successful call returns an array of Person Directory Persons contained in the Dynamic Person Group.

- PersonDirectoryPerson[]
  - `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.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** `44e2cf82becd` — 1 info
  - endpoint added
- **2026-07-13** `e1f63ec9983b` — 1 info
  - endpoint added
- **2026-07-13** `5375faa8d134` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/ai-face/changes/persons/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/44e2cf82becd/schema)