---
title: "Changes to Given an area frame (box defined by the top-right and bottom-left corners),\nit returns all routes and their respective shapes that operate within this area.\nRoutes are filtered by zoom level. On low zoom levels, only long distance trains will be shown\nwhile on high zoom levels, also metros, buses and trams will be returned."
method: GET
path: "/api/experimental/map/routes"
---

# Changes to Given an area frame (box defined by the top-right and bottom-left corners),
it returns all routes and their respective shapes that operate within this area.
Routes are filtered by zoom level. On low zoom levels, only long distance trains will be shown
while on high zoom levels, also metros, buses and trams will be returned.

`GET /api/experimental/map/routes`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 52 revisions.

- **2026-07-16** `dbfe4b7f2bab` — 2 warning
- **2026-05-25** `a2ab90068a35` — 1 info
- **2026-05-21** `f808465a02ed` — 1 warning
- **2026-05-20** `a3620bf004a3` — 1 breaking
- **2026-02-26** `59a65fcef5d9` — 14 breaking, 42 warning, 2 info
- **2026-02-22** `6775a2d6764d` — 1 info
- **2026-02-21** `b7bf68a0d6f3` — 1 breaking

## Changes

- **2026-07-16** `dbfe4b7f2bab` — 2 warning
  - added the new `HGV` enum value to the `routes/items/mode` response property for the response status `200`
  - added the new `HGV` enum value to the `stops/items/modes/items/` response property for the response status `200`
- **2026-05-25** `a2ab90068a35` — 1 info
  - added the optional property `stops/items/stopCode` to the response with the `200` status
- **2026-05-21** `f808465a02ed` — 1 warning
  - added the new `SPECIAL_EVENT` enum value to the `stops/items/alerts/items/cause` response property for the response status `200`
- **2026-05-20** `a3620bf004a3` — 1 breaking
  - the response property `stops/items/level` became optional for the status `200`
- **2026-02-26** `59a65fcef5d9` — 14 breaking, 42 warning, 2 info
  - the `routes/items/segments/items/from` response's property type/format changed from `object`/`` to `integer`/`` for status `200`
  - the `routes/items/segments/items/polyline` response's property type/format changed from `object`/`` to `integer`/`` for status `200`
  - the `routes/items/segments/items/to` response's property type/format changed from `object`/`` to `integer`/`` for status `200`
  - removed the required property `routes/items/segments/items/from/lat` from the response with the `200` status
  - removed the required property `routes/items/segments/items/from/level` from the response with the `200` status
  - removed the required property `routes/items/segments/items/from/lon` from the response with the `200` status
  - removed the required property `routes/items/segments/items/from/name` from the response with the `200` status
  - removed the required property `routes/items/segments/items/polyline/length` from the response with the `200` status
  - removed the required property `routes/items/segments/items/polyline/points` from the response with the `200` status
  - removed the required property `routes/items/segments/items/polyline/precision` from the response with the `200` status
  - removed the required property `routes/items/segments/items/to/lat` from the response with the `200` status
  - removed the required property `routes/items/segments/items/to/level` from the response with the `200` status
  - removed the required property `routes/items/segments/items/to/lon` from the response with the `200` status
  - removed the required property `routes/items/segments/items/to/name` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/alerts` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/arrival` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/cancelled` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/departure` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/description` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/dropoffType` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/flex` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/flexEndPickupDropOffWindow` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/flexId` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/flexStartPickupDropOffWindow` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/importance` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/modes` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/parentId` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/pickupType` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/scheduledArrival` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/scheduledDeparture` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/scheduledTrack` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/stopId` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/track` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/tz` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/from/vertexType` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/to/alerts` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/to/arrival` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/to/cancelled` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/to/departure` from the response with the `200` status
  - removed the optional property `routes/items/segments/items/to/description` from the response with the `200` status
  - …18 more
- **2026-02-22** `6775a2d6764d` — 1 info
  - endpoint added
- **2026-02-21** `b7bf68a0d6f3` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/motis-project/apis/motis-api/docs/api/experimental/map/routes/get.md) · [API](https://skmtc.dev/motis-project/apis/motis-api.md) · [Page](https://skmtc.dev/motis-project/apis/motis-api/changes/api/experimental/map/routes/get)