---
title: "GET /persongroups/{personGroupId}/persons/{personId}/persistedfaces/{persistedFaceId}"
method: GET
path: "/persongroups/{personGroupId}/persons/{personId}/persistedfaces/{persistedFaceId}"
---

# GET /persongroups/{personGroupId}/persons/{personId}/persistedfaces/{persistedFaceId}

`GET /persongroups/{personGroupId}/persons/{personId}/persistedfaces/{persistedFaceId}`

## Request

- Base URL: `{endpoint}/face/{apiVersion}`
- URL: `{endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons/{personId}/persistedfaces/{persistedFaceId}`
- Auth: one of:
  - API key in header `Ocp-Apim-Subscription-Key`
  - OAuth 2
    - Authorization code: `https://api.example.com/oauth2/authorize`
    - Token URL: `https://api.example.com/oauth2/token` scopes: `https://cognitiveservices.azure.com/.default`

Retrieve person face information. The persisted person face is specified by its personGroupId, personId and persistedFaceId.

## Path parameters

- `personGroupId` string, required
- `personId` string, uuid, required
- `persistedFaceId` string, uuid, required

## Response `200`

A successful call returns target persisted face's information (persistedFaceId and userData).

- PersonGroupPersonFace: Face resource for person group person.
  - `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.

## Changes

- **2026-07-13** `e1f63ec9983b`: 1 info
  - api operation id `PersonGroupPerson_GetFace` removed and replaced with `PersonGroupOperations_GetPersonGroupPersonFace`

[Operation history](https://skmtc.dev/azure/apis/ai-face/changes/persongroups/:personGroupId/persons/:personId/persistedfaces/:persistedFaceId/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.dev/azure/apis/ai-face/revisions/e9a68c525be6?raw)
