---
title: "List trips"
method: GET
path: "/api/trips"
tags: ["Trips"]
---

# List trips

`GET /api/trips`

## Request

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

Every trip the caller can see, newest first: the caller's account's trips plus trips shared with them individually. Each carries its places, travellers and photo count.

## Query parameters

- `status` 'past' | 'planning' | 'booked' | 'active': Only trips with this status.

## Response `200`

Trips, newest first.

- TripSummary[]
  - `id` string, required
  - `title` string, required
  - `start_date` string, nullable, required: Date, YYYY-MM-DD.
  - `end_date` string, nullable, required: Date, YYYY-MM-DD.
  - `status` 'past' | 'planning' | 'booked' | 'active', required
  - `notes` string, nullable, required
  - `evidence_status` string, nullable, required: From the original import: how well the trip is evidenced.
  - `cover_photo_id` string, nullable, required
  - `photo_count` integer, required
  - `booking_count` integer
  - `first_photo_id` string, nullable, required
  - `places` TripPlaceSummary[], required
    - `name` string, required
    - `country` string, nullable, required: Readable country name.
    - `lat` number, nullable, required
    - `lon` number, nullable, required
    - `kind` 'destination' | 'layover' | 'origin', required
  - `travelers` Traveler[], required
    - `id` string, required
    - `name` string, 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.

---

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