---
title: "People with faces, and the review backlog"
method: GET
path: "/api/faces/overview"
tags: ["Faces"]
---

# People with faces, and the review backlog

`GET /api/faces/overview`

## Request

- Base URL: `https://trvlrr.app`
- URL: `https://trvlrr.app/api/faces/overview`
- Auth: HTTP bearer

## Response `200`

People, a sample face each, and counts.

- FacesOverview
  - `people` object[], required
    - `id` string, required
    - `name` string, required
    - `avatar_updated_at` string, nullable, required
    - `has_avatar` integer, required: 0 or 1.
    - `confirmed` integer, required
    - `suggested` integer, required
  - `samples` object[], required
    - `person_id` string, required
    - `photo_id` string, required
    - `x` number, required
    - `y` number, required
    - `w` number, required
    - `h` number, required
  - `unassigned` integer, required
  - `pending_photos` integer, required

## Other responses

- `401`: No usable credential: a Clerk session token, a device token or an OAuth access token is required.
- `402`: Trvlrr Plus is required, or this month's AI allowance is used up.
- `403`: The caller may not do this to this account or trip.

---

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