---
title: "Photos not yet scanned for faces"
method: GET
path: "/api/faces/pending"
tags: ["Faces"]
---

# Photos not yet scanned for faces

`GET /api/faces/pending`

## Request

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

The phone runs face detection on thumbnails and posts the results to /api/faces/scan-result. Newest first; limit up to 100 (default 40).

## Query parameters

- `limit` integer, nullable: Up to 100.

## Response `200`

Photo ids to scan, and how many remain.

- FacesPending
  - `photo_ids` string[], required
  - `remaining` 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)