---
title: "The journey a trip's photos trace"
method: GET
path: "/api/trips/{id}/journey"
tags: ["Photos"]
---

# The journey a trip's photos trace

`GET /api/trips/{id}/journey`

## Request

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

Geotagged photos clustered by day and place (about 2 km), each cluster with its span, a representative photo and the best landmark guess, with the person's renames applied and hidden stops removed.

## Path parameters

- `id` string, required: The trip id.

## Response `200`

Stops in time order.

- JourneyStop[]
  - `date` string, required
  - `lat` number, required
  - `lon` number, required
  - `count` integer, required
  - `photo_id` string, required: A representative photo.
  - `first_time` string, required
  - `last_time` string, required
  - `landmark` string, nullable, required: Best AI landmark guess.
  - `custom_name` string, nullable, required: A name the person gave the stop.

## Other responses

- `401`: No usable credential: a Clerk session token, a device token or an OAuth access token is required.
- `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)