---
title: "Faces to review, clustered"
method: GET
path: "/api/faces/unassigned"
tags: ["Faces"]
---

# Faces to review, clustered

`GET /api/faces/unassigned`

## Request

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

Unassigned and suggested faces grouped by similarity, largest group first, so the person can answer "who is this?" once per group.

## Response `200`

Clusters.

- FaceCluster[]
  - `key` string, required
  - `suggested_person_id` string, nullable, required
  - `suggested_name` string, nullable, required
  - `faces` object[], required
    - `id` string, required
    - `photo_id` string, required
    - `x` number, required
    - `y` number, required
    - `w` number, required
    - `h` number, required
    - `person_id` string, nullable, required
    - `auto` integer, required: 0 or 1.

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