---
title: "Every located place, and the flights between them"
method: GET
path: "/api/map"
tags: ["Places"]
---

# Every located place, and the flights between them

`GET /api/map`

## Request

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

Pins for all trips including planned ones; flight arcs only for travel that has happened. Points carry kind (destination, layover, origin) so a client can style them.

## Response `200`

Points and arcs.

- Map
  - `points` MapPoint[], required
    - `name` string, required
    - `country` string, nullable, required
    - `locality` string, nullable, required
    - `locality_country` string, nullable, required
    - `lat` number, required
    - `lon` number, required
    - `kind` 'destination' | 'layover' | 'origin', required
    - `trip_id` string, required
    - `title` string, required
    - `start_date` string, nullable, required
    - `status` 'past' | 'planning' | 'booked' | 'active', required
  - `unlocated` integer, required: Destinations without coordinates.
  - `flights` object[], required
    - `from` object, required
      - `lat` number, required
      - `lon` number, required
      - `code` string, nullable, required
      - `name` string, required
    - `to` object, required
      - `lat` number, required
      - `lon` number, required
      - `code` string, nullable, required
      - `name` string, required
    - `count` integer, required
  - `flights_unlocated` integer, 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)