Sign in
timetable

Get the next N departures or arrivals of a stop sorted by time

get/api/v6/stoptimes

Query parameters

stopIdstring

stop id of the stop to retrieve departures/arrivals for

centerstring

Anchor coordinate. Format: latitude,longitude pair. Used as fallback when stopId is missing or can't be found. If both are provided and stopId resolves, stopId is used. If stopId does not resolve, center is used instead. radius is required when querying by "center" (i.e. without a valid stopId). This can be used to hedge against changing stopIds. Use with a small radius and exactRadius=false to still only return the original stop and stops that MOTIS considers equivalent (parent/children or due to similar name, even outside the radius).

timestring date-time

Optional. Defaults to the current time.

arriveByboolean

Optional. Default is false.

  • arriveBy=true: the parameters date and time refer to the arrival time
  • arriveBy=false: the parameters date and time refer to the departure time
bothboolean

Optional. Default is false. If set to true, returns both arrivals and departures, ignoring arriveBy.

direction'EARLIER' | 'LATER'

This parameter will be ignored in case pageCursor is set.

Optional. Default is

  • LATER for arriveBy=false
  • EARLIER for arriveBy=true

The response will contain the next n arrivals / departures in case EARLIER is selected and the previous n arrivals / departures if LATER is selected.

windowinteger

Optional. Window in seconds around time. Limiting the response to those that are at most window seconds aways in time. If both n and window are set, it uses whichever returns more.

modeMode[]

Optional. Default is all transit modes.

Only return arrivals/departures of the given modes.

ninteger

Minimum number of events to return. If both n and window are provided, the API uses whichever returns more events.

radiusinteger

Optional. Radius in meters.

Default is that only stop times of the parent of the stop itself and all stops with a similar name (+ their child stops) are returned.

If set, all stops at parent stations and their child stops in the specified radius are returned.

exactRadiusboolean

Optional. Default is false.

If set to true, only stations that are phyiscally in the radius are considered. If set to false, additionally to the stations in the radius, equivalences with a similar name and children are considered. Use exactRadius=true with radius=0 if you really only want to get events for the given stopId (platform or bay) and nothing from stops considered equivalent.

fetchStopsboolean

Experimental. Expect unannounced breaking changes (without version bumps).

Optional. Default is false. If set to true, the following stops are returned for departures and the previous stops are returned for arrivals.

pageCursorstring

Use the cursor to go to the next "page" of stop times. Copy the cursor from the last response and keep the original request as is. This will enable you to search for stop times in the next or previous time-window.

withScheduledSkippedStopsboolean

Optional. Include stoptimes where passengers can not alight/board according to schedule.

realtimeMode'OFF' | 'REALTIME_ANNOTATION_ONLY' | 'REALTIME'

Controls whether realtime data (delays, cancellations, added/changed trips) is used.

  • REALTIME: use realtime data for routing/sorting.
  • REALTIME_ANNOTATION_ONLY: route, sort and window on the scheduled timetable only, but still annotate the response with realtime data.
  • OFF: use the scheduled timetable only, with no realtime annotation.

Optional. Default is REALTIME.

Controls whether realtime data is used.

  • REALTIME: realtime data (delays, cancellations) is used stop times are returned and sorted by their realtime time.
  • REALTIME_ANNOTATION_ONLY: stop times are returned, windowed and sorted by their planned time, but each stop time is annotated with realtime data.
  • OFF: only scheduled data is used; stop times are returned and sorted by their planned time, with no realtime annotation.
languagestring[]

language tags as used in OpenStreetMap / GTFS (usually BCP-47 / ISO 639-1, or ISO 639-2 if there's no ISO 639-1)

withAlertsboolean

Optional. Default is true. If set to false, alerts are omitted in the metadata of place for all stopTimes.

Response

A list of departures/arrivals

previousPageCursorstring required

Use the cursor to get the previous page of results. Insert the cursor into the request and post it to get the previous page. The previous page is a set of stop times BEFORE the first stop time in the result.

nextPageCursorstring required

Use the cursor to get the next page of results. Insert the cursor into the request and post it to get the next page. The next page is a set of stop times AFTER the last stop time in this result.

Changes

Changed in 9 of the 52 revisions of this API.11315

  • cdfc151646a84See the full diff
    • ○

      added the optional property stopTimes/items/loopedCalendarSince to the response with the 200 status

      response-optional-property-added

    • ○

      added the required property stopTimes/items/bikesAllowed to the response with the 200 status

      response-required-property-added

    • ○

      added the required property stopTimes/items/reservation to the response with the 200 status

      response-required-property-added

    • ○

      added the required property stopTimes/items/wheelchairAccessible to the response with the 200 status

      response-required-property-added

  • dbfe4b7f2bab71See the full diff
    • ●

      added the new HGV enum value to the place/modes/items/ response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new HGV enum value to the stopTimes/items/mode response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new HGV enum value to the stopTimes/items/nextStops/items/modes/items/ response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new HGV enum value to the stopTimes/items/place/modes/items/ response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new HGV enum value to the stopTimes/items/previousStops/items/modes/items/ response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new HGV enum value to the stopTimes/items/tripFrom/modes/items/ response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new HGV enum value to the stopTimes/items/tripTo/modes/items/ response property for the response status 200

      response-property-enum-value-added

    • ○

      added the enum value HGV to the property items/ of the query request parameter mode

      request-parameter-property-enum-value-added

  • e211cb7a5ecf1See the full diff
    • ○

      added the new enum value REALTIME_ANNOTATION_ONLY to the query request parameter realtimeMode

      request-parameter-enum-value-added

  • 1a0315b56e3d1See the full diff
    • ○

      added the new optional query request parameter realtimeMode

      new-optional-request-parameter

  • 85259ef19b111See the full diff
    • ○

      added the new optional query request parameter both

      new-optional-request-parameter

  • a2ab90068a356See the full diff
    • ○

      added the optional property place/stopCode to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property stopTimes/items/nextStops/items/stopCode to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property stopTimes/items/place/stopCode to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property stopTimes/items/previousStops/items/stopCode to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property stopTimes/items/tripFrom/stopCode to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property stopTimes/items/tripTo/stopCode to the response with the 200 status

      response-optional-property-added

  • f808465a02ed6See the full diff
    • ●

      added the new SPECIAL_EVENT enum value to the place/alerts/items/cause response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new SPECIAL_EVENT enum value to the stopTimes/items/nextStops/items/alerts/items/cause response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new SPECIAL_EVENT enum value to the stopTimes/items/place/alerts/items/cause response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new SPECIAL_EVENT enum value to the stopTimes/items/previousStops/items/alerts/items/cause response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new SPECIAL_EVENT enum value to the stopTimes/items/tripFrom/alerts/items/cause response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new SPECIAL_EVENT enum value to the stopTimes/items/tripTo/alerts/items/cause response property for the response status 200

      response-property-enum-value-added

  • a3620bf004a31See the full diff
    • ○

      endpoint added

      endpoint-added

  • b7bf68a0d6f31See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 30 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog