Aviation Data

Airlines on a route

Which airlines fly one city pair non-stop, busiest first.

GET/v1/aviation/routesRequires X-API-Key

Answers "who flies from A to B non-stop?" from the airlines' published schedules: every carrier that files the pair, ordered by weekly frequency (busiest first), then by airline code.

Both origin and destination are required three-letter IATA airport codes (either case); anything else is 400 invalid_route. The pair is directional — MAD→BCN and BCN→MAD are separate questions — and airport codes match exactly, so a metropolitan code such as LON matches nothing. Ask once per airport.

The list is unpaginated. A pair nobody publishes returns 200 with an empty data, not 404. This describes the airlines' networks, not what Norba can book: use POST /v1/shopping/offers for that.

Request example

curl --request GET \
  --url https://api.norba.io/v1/aviation/routes \
  --header "X-API-Key: $NORBA_KEY"

Response example

{
  "data": [
    {
      "airline_iata": "IB",
      "origin": "MAD",
      "destination": "BCN",
      "weekly_frequency": 98,
      "monthly_seats": 72400,
      "source": "opentraveldata"
    },
    {
      "airline_iata": "VY",
      "origin": "MAD",
      "destination": "BCN",
      "weekly_frequency": 42,
      "monthly_seats": 32600,
      "source": "opentraveldata"
    },
    {
      "airline_iata": "UX",
      "origin": "MAD",
      "destination": "BCN",
      "weekly_frequency": 35,
      "monthly_seats": 25900,
      "source": "opentraveldata"
    }
  ],
  "meta": {
    "request_id": "9b0d6e3f1a47c825",
    "page": 1,
    "limit": 3,
    "count": 3,
    "total": 3
  },
  "errors": []
}

Authorization

X-API-KeystringRequired

Opaque API key issued from the Norba dashboard. Sent on every request as the X-API-Key HTTP header. Missing or invalid keys are rejected with 401 Unauthorized.

Query parameters

originstringRequired

Three-letter IATA code of the departure airport.

Example: MAD

destinationstringRequired

Three-letter IATA code of the arrival airport.

Example: BCN

Response fields

airline_iatastringRequired

A carrier that files the pair.

originstringRequired

Departure airport, as asked.

destinationstringRequired

Arrival airport, as asked.

weekly_frequencynumber

That carrier's flights a week on the pair, averaged over the schedule season. Absent when not published.

monthly_seatsinteger

Seats it offers a month on the pair. Absent when not published.

sourcestring

The dataset the pair comes from: opentraveldata.

Error codes

400

invalid_route — origin or destination is missing or not three characters long.