---
title: "The faces in one photo"
method: GET
path: "/api/faces/photo/{id}"
tags: ["Faces"]
---

# The faces in one photo

`GET /api/faces/photo/{id}`

## Request

- Base URL: `https://trvlrr.app`
- URL: `https://trvlrr.app/api/faces/photo/{id}`
- Auth: HTTP bearer

With names where known. scanned says whether the photo has been through detection at all.

## Path parameters

- `id` string, required: The id.

## Response `200`

Faces, largest first.

- PhotoFaces
  - `scanned` boolean, 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.
    - `person_name` string, nullable, required
    - `avatar_updated_at` string, nullable, required
    - `has_avatar` 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.
- `404`: No such thing, or not one the caller can see.

---

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