API catalogue
Open APIs
- Emissions CalculatorThis API calculates the CO2e emission of a trip for different transport modes. For most transport modes, the SINTEF energy module calculates the emission. It uses the route and a typical vehicle for the transport mode. The emission includes the full lifecycle of the vehicle: production of the fuel or energy, manufacture, maintenance and tailpipe emission. For bike, electrical bike and electrical scooter, the API uses a fixed emission factor for each passenger kilometre. SINTEF supplies these factors. ## Client identification Send the header `ET-Client-Name` in all requests. Use the format `<party>-<application>`, for example `brakar-journeyplanner`. If a client does not send the header, Entur can apply a stricter rate limit to it or block it. ## Rate limits Each client has a limit for the number of requests each minute and for the highest rate. The API identifies the client from `ET-Client-Name`. A client without the header, or with a name that Entur has not agreed a limit for, can send 60 requests each minute and 5 requests each second. Without the header, the limit applies to each IP address. If a client is over its limit, the API answers with status 429. Wait the number of seconds in the `Retry-After` header before you send more requests. Contact Entur if your client needs a higher limit. ## Correlation ID Each response has the header `x-correlation-id`. You can send your own value in this header. Use only letters, digits and the characters `.`, `_`, `:` and `-`, with a maximum of 128 characters. Otherwise the API makes a new value. An error response also gives the correlation ID in `instance`. Give this value when you contact Entur about a request.
- GeocoderGeocoding and reverse geocoding for Norwegian addresses and points of interest.
- Distances and zonesCalculates distances between Stop Places
- Stop Place RegisterThe Stop Place Register provides access to public transportation infrastructure data across Norway, including stop places, quays, parkings, and related NeTEx entities. This API enables developers to query stop place information with details on location, accessibility features, transport modes, fare zones, and hierarchical relationships. Ideal for journey planning applications, transportation analysis, mobility services, and public transit integrations.
- Timetable Import InfoAPI for checking the status of timetable data imports. The endpoint returns the date of the latest successful import of timetable data into Entur's systems for each data provider. Data providers are identified by their [codespaces](https://enturas.atlassian.net/wiki/spaces/PUBLIC/pages/637370434/List+of+current+Codespaces) This import date is also displayed in the list of NeTEx files available on Entur Open Data Portal. Additionally, the import date is stored in each NeTEx archive available on this page, in the "created" timestamp of the CompositeFrame. For example: created="2019-05-29T12:59:32.202" The date returned by this service is the original import date, i.e. the date Entur received the source dataset from the data provider. It may be different from the creation date of the archives listed on open data page, since these archives are regenerated every day through a filtering process that removes obsolete data. ## Authentication This API is open under NLOD licence, however, it is required that all consumers identify themselves by using the header ET-Client-Name. Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers. The structure of ET-Client-Name should be: "company-application" *Header examples:* - "brakar-journeyplanner" - "fosen_utvikling-departureboard" - "nor_way_bussekspress-nwy-app"
- Journey PlannerThis API is the core service for journey planning and uses OpenTripPlanner software to provide departure boards for individual stops, and point-to-point journey planning for all public transport in Norway, including real-time information, regardless of transport mode, or operator. All data is presented as a Transmodel-based GraphQL-API.
- MobilityThe Mobility API is an aggregation service for shared mobility data in Norway. It provides access to real-time information about shared bikes, e-scooters, and other mobility services from multiple operators across Norwegian cities.
- Vehicle PositionsThe Vehicle Positions API is a GraphQL service that provides real-time positions and status for public transport vehicles across Norway. It enables fetching and streaming live vehicle data including location, delays, occupancy, and journey information.
Last modified on
Did you find what you were looking for?