Current Version

By default, all requests will receive the v1 of the API. We encourage you to explicitly request this version via the Accept header.

Versions

Currently, there exists one version of the Norwegian Routes API: the v1 version.

By default, all requests receive the v1 version. We encourage you to explicitly request this version via Accept header.

Media Types

Custom media types are used in the API to let consumers choose the format of the data they wish to receive. This is done by adding one or more of the following types to the Accept header when you make a request. Media types are specific to resources, allowing them to change independently and support formats that other resources don’t.

All Norwegian Routes media types look like this:

application/vnd.nas.routes[.version].param[+json]

The most basic media types the API supports are:

application/json
application/vnd.nas.routes.v1+json
Important
 the default version of the API may change in the future. If you’re building an application and care about the stability of the API, be sure to request a specific version in the Accept header as shown in the examples below.

You can specify a version like so:

application/vnd.nas.routes.v1+json

You can check the current version through every response’s contentType header:

HTTP Response
[show]

Routes

GET

/routes

Routes information.

Routes - exclude transits

The routes endpoint does not include transits by default.

Request

HTTP Request
[show]

Response

HTTP Response
[show]
Table 1. Routes
Name Type Required Default Description

routes

Array

Yes

None

Routes information

routes[].departure.airportCode

String

Yes

None

Departure (origin) airport code

routes[].arrival.airportCode

String

Yes

None

Arrival (destination) airport code

Routes - include transits

The routes endpoint does not include transits by default. If you want transits to be included you have to set the includeTransit flag to true.

Request

HTTP Request
[show]

Response

HTTP Response
[show]
Table 2. Routes
Name Type Required Default Description

routes

Array

Yes

None

Routes information

routes[].departure.airportCode

String

Yes

None

Departure (origin) airport code

routes[].arrival.airportCode

String

Yes

None

Arrival (destination) airport code

routes[].flightSegments[].departure.airportCode

String

No

None

Flight segment - departure (origin) airport code

routes[].flightSegments[].arrival.airportCode

String

No

None

Flight segment - arrival (destination) airport code