Journey Planner v3 BETA

This 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.

Journey planner API v3 is a new service running on OpenTripPlanner 2.0. This service is currently labelled BETA but can be used for testing purposes. Removal of BETA status is estimated for April 2021. The v3 service will not be backward compatible with v2.

Base URL: https://api.entur.io/journey-planner/v3/graphql

To make it easier for our users to construct valid API-queries, we have an IDE for the API where you also find the documentation.

GraphQL IDE: https://api.entur.io/graphql-explorer/journey-planner-v3-beta

Are you new to GraphQL? You can read more about it here: https://graphql.org/

We also provide a JavaScript SDK which supports a lot of JourneyPlanner's queries.

Example queries

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"

API

There is only one endpoint!

POST https://api.entur.io/journey-planner/v3/graphql

Headers

  • Content-Type: application/json
  • ET-Client-Name: <company>-<application> (See Authentication section above)

Body

A JSON body with a "query" field and optionally "variables".

{
    "query": "string",
    "variables": {
        "myVariable": "value"
    }
}