API Reference

HTTP POST (Standard SIRI 2.0)

Publish/subscribe: https://api.entur.io/realtime/v1/subscribe

Request/Response: https://api.entur.io/realtime/v1/services

Get data for only one operator, add /<Codespace-ID> to the end of URL. You can find the operator's Codespace-ID in the list located at Intro.

Example: https://api.entur.io/realtime/v1/services/RUT

HTTP GET (Standard SIRI 2.0 Lite)

HTTP GET https://api.entur.io/realtime/v1/rest/sx

HTTP GET https://api.entur.io/realtime/v1/rest/vm

HTTP GET https://api.entur.io/realtime/v1/rest/et

Optional HTTP-parameters

datasetId

• E.g. datasetId=RUT. You can find the operator's Codespace-ID in the list located at Intro.
• Limits the results to original dataset-provider

Example: https://api.entur.io/realtime/v1/rest/et?datasetId=RUT

excludedDatasetIds

• Comma-separated list of datasets to exclude from result
• E.g. excludedDatasetIds=RUT,NSB
• Limits result by excluding data from the provided datasetIds
• Note: Valid for VM and ET requests only (I.e. the opposite of parameter datasetId)

Example: https://api.entur.io/realtime/v1/rest/et?excludedDatasetIds=BNR,OST,RUT

useOriginalId

By default we return data with IDs mapped to those used in the static route data. Instead, if you want the original IDs delivered from the underlying system, you can add a URL parameter useOriginalId = true.

NB: This is also supported by SIRI Publish/subscribe and Request/Response

Example: https://api.entur.io/realtime/v1/rest/sx?useOriginalId=true

maxSize

• E.g. maxSize=10 (default is 1500)
• Limits the number of elements in the returned result. requestorId will be used to track changes since last request and is provided in result. An id will be created and returned if not provided.
• If more data exists, the attribute MoreData will be set to true

Example: https://api.entur.io/realtime/v1/rest/et?maxSize=10

requestorId

• E.g. requestorId=757c9284-0f12-4a46-a557-33a19e80119b
• Value needs to be unique for as long as only updated data are needed, a UUID should be used
• First request creates a short lived session (timeout after e.g. 5 minutes)
• Subsequent requests returns only changes since last request with the same requestorId

Example: https://api.entur.io/realtime/v1/rest/sx?requestorId=757c9284-0f12-4a46-a557-33a19e80119b

HTTP GET (GTFS-RT)

HTTP GET https://api.entur.io/realtime/v1/gtfs-rt/trip-updates

HTTP GET https://api.entur.io/realtime/v1/gtfs-rt/vehicle-positions

HTTP GET https://api.entur.io/realtime/v1/gtfs-rt/alerts

datasource

• E.g. datasource=RUT. You can find the operator's Codespace-ID in the list located at Intro.
• Limits the results to original dataset-provider