---
title: "Get Person Faces Endpoint"
method: GET
path: "/getPersonFaces"
---

# Get Person Faces Endpoint

`GET /getPersonFaces`

## Request

- Base URL: `https://api.pavoot.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pavoot.com/getPersonFaces`
- Auth: none declared

Returns faces for the given person. For photographer role, only returns faces from that photographer's images.

Paged by `offset`/`limit` (face rows, not crops: a crop that fails is dropped, so use
`next_offset` / `has_more` to page). Capped at 12 per call — every crop decodes an original.

`includeUnboxed`: also return faces with no usable box (hand tags) and faces whose crop
failed, with `cropped_face: null`, so a caller can list EVERY photo the person is on.

## Query parameters

- `personId` string, required
- `projectId` string, required
- `offset` integer
- `limit` integer
- `includeUnboxed` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-30** `b924f00a2acd`: 3 info
  - added the new optional `query` request parameter `includeUnboxed`
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `offset`

[Operation history](https://skmtc.dev/pavoot/apis/pavoot-api/changes/getPersonFaces/get.md)

---

[API](https://skmtc.dev/pavoot/apis/pavoot-api.md) - [All operations](https://skmtc.dev/pavoot/apis/pavoot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pavoot/apis/pavoot-api/revisions/8c0cd91c2a05?raw)