---
title: "Get all stops for a map section"
method: GET
path: "/api/v6/map/stops"
tags: ["map"]
---

# Get all stops for a map section

`GET /api/v6/map/stops`

## Query parameters

- `min` string, required
- `max` string, required
- `grouped` boolean
- `modes` Mode[]
- `language` string[]

## Response `200`

array of stop places in the selected map section

- Place[]
  - `name` string, required — name of the transit stop / PoI / address
  - `stopId` string — The ID of the stop. This is often something that users don't care about.
  - `parentId` string — If it's not a root stop, this field contains the `stopId` of the parent stop.
  - `importance` number — The importance of the stop between 0-1.
  - `lat` number, required — latitude
  - `lon` number, required — longitude
  - `level` number — level according to OpenStreetMap If no level is given, the field will be unset. For older versions (v1-v5), this field is mandatory and therefore set to 0. Affected endpoints: plan, trip, stoptimes, one-to-all, map/stops, map/trips
  - `tz` string — timezone name (e.g. "Europe/Berlin")
  - `arrival` string, date-time — arrival time
  - `departure` string, date-time — departure time
  - `scheduledArrival` string, date-time — scheduled arrival time
  - `scheduledDeparture` string, date-time — scheduled departure time
  - `scheduledTrack` string — scheduled track from the static schedule timetable dataset
  - `track` string — The current track/platform information, updated with real-time updates if available. Can be missing if neither real-time updates nor the schedule timetable contains track information.
  - `stopCode` string — Short, abbreviated identifier of the stop intended for users (e.g. printed on signage, used in SMS / passenger info systems). Comes from the GTFS `stop_code` field.
  - `description` string — description of the location that provides more detailed information
  - `vertexType` 'NORMAL' | 'BIKESHARE' | 'TRANSIT' — - `NORMAL` - latitude / longitude coordinate or address - `BIKESHARE` - bike sharing station - `TRANSIT` - transit stop
  - `pickupType` 'NORMAL' | 'NOT_ALLOWED' — - `NORMAL` - entry/exit is possible normally - `NOT_ALLOWED` - entry/exit is not allowed
  - `dropoffType` 'NORMAL' | 'NOT_ALLOWED' — - `NORMAL` - entry/exit is possible normally - `NOT_ALLOWED` - entry/exit is not allowed
  - `cancelled` boolean — Whether this stop is cancelled due to the realtime situation.
  - `alerts` Alert[] — Alerts for this stop.
    - `code` string — Attribute or notice code (e.g. for HRDF or NeTEx)
    - `communicationPeriod` TimeRange[] — Time when the alert should be shown to the user. If missing, the alert will be shown as long as it appears in the feed. If multiple ranges are given, the alert will be shown during all of them.
      - `start` string, date-time, required — If missing, the interval starts at minus infinity. If a TimeRange is provided, either start or end must be provided - both fields cannot be empty.
      - `end` string, date-time, required — If missing, the interval ends at plus infinity. If a TimeRange is provided, either start or end must be provided - both fields cannot be empty.
    - `impactPeriod` TimeRange[] — Time when the services are affected by the disruption mentioned in the alert.
      - `start` string, date-time, required — If missing, the interval starts at minus infinity. If a TimeRange is provided, either start or end must be provided - both fields cannot be empty.
      - `end` string, date-time, required — If missing, the interval ends at plus infinity. If a TimeRange is provided, either start or end must be provided - both fields cannot be empty.
    - `cause` 'UNKNOWN_CAUSE' | 'OTHER_CAUSE' | 'TECHNICAL_PROBLEM' | 'STRIKE' | 'DEMONSTRATION' | 'ACCIDENT' | 'HOLIDAY' | 'WEATHER' | 'MAINTENANCE' | 'CONSTRUCTION' | 'POLICE_ACTIVITY' | 'MEDICAL_EMERGENCY' | 'SPECIAL_EVENT' — Cause of this alert.
    - `causeDetail` string — Description of the cause of the alert that allows for agency-specific language; more specific than the Cause.
    - `effect` 'NO_SERVICE' | 'REDUCED_SERVICE' | 'SIGNIFICANT_DELAYS' | 'DETOUR' | 'ADDITIONAL_SERVICE' | 'MODIFIED_SERVICE' | 'OTHER_EFFECT' | 'UNKNOWN_EFFECT' | 'STOP_MOVED' | 'NO_EFFECT' | 'ACCESSIBILITY_ISSUE' — The effect of this problem on the affected entity.
    - `effectDetail` string — Description of the effect of the alert that allows for agency-specific language; more specific than the Effect.
    - `url` string — The URL which provides additional information about the alert.
    - `headerText` string, required — Header for the alert. This plain-text string will be highlighted, for example in boldface.
    - `descriptionText` string, required — Description for the alert. This plain-text string will be formatted as the body of the alert (or shown on an explicit "expand" request by the user). The information in the description should add to the information of the header.
    - `ttsHeaderText` string — Text containing the alert's header to be used for text-to-speech implementations. This field is the text-to-speech version of header_text. It should contain the same information as headerText but formatted such that it can read as text-to-speech (for example, abbreviations removed, numbers spelled out, etc.)
    - `ttsDescriptionText` string — Text containing a description for the alert to be used for text-to-speech implementations. This field is the text-to-speech version of description_text. It should contain the same information as description_text but formatted such that it can be read as text-to-speech (for example, abbreviations removed, numbers spelled out, etc.)
    - `severityLevel` 'UNKNOWN_SEVERITY' | 'INFO' | 'WARNING' | 'SEVERE' — The severity of the alert.
    - `imageUrl` string — String containing an URL linking to an image.
    - `imageMediaType` string — IANA media type as to specify the type of image to be displayed. The type must start with "image/"
    - `imageAlternativeText` string — Text describing the appearance of the linked image in the image field (e.g., in case the image can't be displayed or the user can't see the image for accessibility reasons). See the HTML spec for alt image text.
  - `flex` string — for `FLEX` transports, the flex location area or location group name
  - `flexId` string — for `FLEX` transports, the flex location area ID or location group ID
  - `flexStartPickupDropOffWindow` string, date-time — Time that on-demand service becomes available
  - `flexEndPickupDropOffWindow` string, date-time — Time that on-demand service ends
  - `modes` Mode[] — available transport modes for stops

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/motis-project/apis/motis-api.md) · [All operations](https://skmtc.net/motis-project/apis/motis-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/motis-project/motis-api/versions/947bd5a43e8d/schema)