---
title: "A year in review"
method: GET
path: "/api/review/{year}"
tags: ["Stats"]
---

# A year in review

`GET /api/review/{year}`

## Request

- Base URL: `https://trvlrr.app`
- URL: `https://trvlrr.app/api/review/{year}`
- Auth: HTTP bearer

Trips, nights away, countries (and which were new), distance flown and covered, the longest trip, the busiest month, companions and a notable place. Completed years only.

## Path parameters

- `year` string, required: A completed year, e.g. 2019.

## Response `200`

The year.

- YearReview
  - `year` integer, required
  - `trips` integer, required
  - `nights_away` integer, required
  - `countries` object[], required
    - `name` string, nullable, required
    - `is_new` boolean, required
  - `distance` object, required
    - `flown_km` number, required
    - `flown_legs` number, required
    - `flown_measured_legs` number, required
    - `covered_km` number, required
    - `covered_legs` number, required
    - `covered_measured_legs` number, required
  - `longest_trip` object, nullable, required
    - `id` string, required
    - `title` string, required
    - `start_date` string, required
    - `end_date` string, nullable, required
    - `nights` integer, required
  - `busiest_month` object, nullable, required
    - `month` integer, required
    - `name` string, nullable, required
    - `trips` integer, required
  - `companions` object[], required
    - `id` string, required
    - `name` string, required
    - `trips` integer, required
  - `notable_place` object, nullable, required
    - `name` string, required
    - `country` string, nullable, required
    - `trip_id` string, required
    - `trip_title` string, required

## Other responses

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