---
title: "All photos the caller can see, paginated"
method: GET
path: "/api/photos"
tags: ["Photos"]
---

# All photos the caller can see, paginated

`GET /api/photos`

## Request

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

Across every trip, newest first. limit is capped at 200 (default 60).

## Query parameters

- `limit` integer, nullable: Page size.
- `offset` integer, nullable: Rows to skip.

## Response `200`

A page of photos.

- PhotoListItem[]
  - `id` string, required
  - `thumb_r2_key` string, nullable, required: Pass to GET /api/blob?key= for the fastest thumbnail.
  - `taken_at` string, nullable, required
  - `lat` number, nullable, required
  - `lon` number, nullable, required
  - `content_type` string, nullable, required
  - `trip_id` string, required
  - `trip_cover` string, nullable, required: The trip's cover photo id.

## Other responses

- `401`: No usable credential: a Clerk session token, a device token or an OAuth access token is required.

---

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