---
title: "Homes over the years"
method: GET
path: "/api/homes"
tags: ["Profile"]
---

# Homes over the years

`GET /api/homes`

## Request

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

Where the person has lived, oldest first. Homes decide trips home versus away and where planning starts.

## Response `200`

Homes.

- Home[]
  - `id` string, required
  - `city` string, required
  - `country` string, nullable, required: ISO alpha-2.
  - `hometown` string, nullable, required
  - `gateway` string, nullable, required: The city they usually fly from.
  - `from_date` string, nullable, required: YYYY or YYYY-MM-DD.
  - `to_date` string, nullable, required: YYYY or YYYY-MM-DD; null for the current home.
  - `created_at` string, required

## Other responses

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