Guides · Aviation Data

Aviation Data Reference

Reference data on airports, airlines, airline route networks and aircraft types, built from open datasets. Codes are IATA (International Air Transport Association) and ICAO (International Civil Aviation Organization) codes, in either case. The data describes aviation, not what Norba can book: search for that.

D-231Reference data, as an airport

Endpoints

Errors leave data null and name a code in errors: not_found (404), invalid_airline, invalid_page, invalid_route (400). API-key and quota refusals use the standard error body.
Every call needs an API key and is metered like any other request — see Pricing.
Lists take ?page= (1–1000, default 1) and ?limit= (default 50; above 500 is capped at 500).
Responses are { data, meta, errors }. meta.request_id matches the X-Request-ID header; lists add count, last_updated, limit, page and total.

Category	Endpoint	Returns
Aircraft	GET /v1/aviation/aircraft-types	Search and filter aircraft types
Aircraft	GET /v1/aviation/aircraft-types/{icao_type}	One aircraft type
Aircraft	GET /v1/aviation/manufacturers	Manufacturer names
Aircraft	GET /v1/aviation/manufacturers/{name}/aircraft-types	One manufacturer's types
Airlines	GET /v1/aviation/airlines	Search and filter airlines
Airlines	GET /v1/aviation/airlines/iata/{iata}	One airline by IATA code
Airlines	GET /v1/aviation/airlines/icao/{icao}	One airline by ICAO code
Airlines	GET /v1/aviation/airlines/{id}	One airline by id
Airlines	GET /v1/aviation/airlines/{id}/status	Status only
Airports	GET /v1/aviation/airports	Search and filter airports
Airports	GET /v1/aviation/airports/iata/{iata}	One airport by IATA code
Airports	GET /v1/aviation/airports/icao/{icao}	One airport by ICAO code
Airports	GET /v1/aviation/airports/{id}	One airport by IATA code or id
Airports	GET /v1/aviation/airports/{id}/frequencies	Radio frequencies
Airports	GET /v1/aviation/airports/{id}/full	Airport with runways, frequencies and navaids
Airports	GET /v1/aviation/airports/{id}/navaids	Navigation aids
Airports	GET /v1/aviation/airports/{id}/runways	Runways
Airports	GET /v1/aviation/airports/{id}/timezone	Time zone only
Routes	GET /v1/aviation/airlines/{id}/network	One airline's network in numbers
Routes	GET /v1/aviation/airlines/{id}/routes	One airline's non-stop pairs
Routes	GET /v1/aviation/networks	Airlines by network size, or serving one airport
Routes	GET /v1/aviation/routes	Airlines flying one airport pair
System	GET /v1/reference/sources	Data sources and licences

Airports

For a booking form, send ?q= with ?commercial=true. ?q= matches an exact IATA code or part of the name or city, exact code first. ?commercial=true keeps points a ticket can be sold to, without rail or bus stations. ?metro=LON returns the city and its airports; ?iata= takes a comma-separated list. /airports/{id} takes the IATA code or Norba id, not an ICAO code: use /airports/icao/{icao}.

Field	Type	Description
airport_type	string	balloonport, closed, heliport, large_airport, medium_airport, metropolitan_area (LON, NYC), seaplane_base or small_airport.
city	string	City served.
country	string	ISO 3166-1 alpha-2 country code.
elevation_ft	integer	Elevation in feet, when known.
iata_code	string (3)	IATA code (LHR). Absent when the point has none.
icao_code	string (4)	ICAO code (EGLL), when it has one.
id	string	Norba id: the lowercase IATA code, or another identifier for an airfield without one.
latitude / longitude	number	Decimal degrees.
location_type	string	A airport, B bus station, C city, H heliport, O off-line point, P port, R rail station. Letters combine when a point is several (CA = city and airport).
metro_code	string (3)	The city code it is sold under (LHR → LON).
name	string	Airport name.
page_rank	number	0–1: how likely this is the point a traveller meant. Orders ?q= matches and ?sort=rank. Absent when unranked.
region	string	ISO 3166-2 subdivision (GB-ENG), when known.
scheduled_service	boolean	The airport's own claim of scheduled service; prefer served_by_schedule.
served_by_schedule	boolean	An airline files scheduled flights here (for a metro code, at any of its airports). Use it to decide whether a ticket can be sold to this code.
timezone	string	IANA time zone (Europe/London), when known.

Airlines

Filter with ?alliance=, ?country=, ?iata=, ?icao=, ?name= and ?status=. /airlines/{id} takes the Norba id; for an ICAO code use /airlines/icao/{icao}.

Field	Type	Description
alliance	string	oneworld, SkyTeam or Star Alliance; absent when none.
callsign	string	Radio callsign.
country	string	ISO 3166-1 alpha-2 country code.
hubs / base_airports	array<string>	Airport codes, when known.
iata_code	string (2)	IATA code (BA).
icao_code	string (3)	ICAO code (BAW).
id	string	Norba id: the lowercase IATA code, or the ICAO code for an airline without one.
name	string	Airline name.
status	string	active, inactive or defunct.

Route Networks

Each airline's non-stop network from its published schedules: what airlines fly, not what Norba can book. /airlines/{id}/routes ({id} = two-character IATA code) is busiest first and filters by ?origin=, ?destination= or ?q=. /networks?serving=NDR lists the airlines at an airport. /routes?origin=ATH&destination=LHR lists the airlines on one pair, in that direction.

Field	Type	Description
airline_iata	string (2)	The airline the pair is listed under.
monthly_seats	integer	Seats a month. Absent when not published.
origin / destination	string (3)	Airport IATA codes. One direction per record.
source	string	The dataset the pair comes from.
weekly_frequency	number	Flights a week, averaged over the schedule season. Absent when not published.

Network summary

Returned by /airlines/{id}/network, and one row per airline by /networks.

Field	Type	Description
airline_iata / airline_name	string	The airline. The name falls back to the code when no profile is on file.
airport_count	integer	Distinct airports it departs from.
country / alliance	string	When known.
route_count	integer	One-direction non-stop pairs: A→B and B→A count as two.
updated_at	string	Last refresh (RFC 3339).
weekly_flights	number	Flights a week across the network, when published.

Aircraft Types

Looked up by ICAO type designator; IATA aircraft codes (77W, 32N) return 404. Filter the list with ?class= and ?manufacturer=. Records also carry dimensions and weights when known.

Field	Type	Description
aircraft_class	string	narrowbody, regional, rotorcraft, turboprop or widebody.
description	string	Short description.
engine_type	string	electric, jet, piston, rotorcraft or turboprop.
icao_type_code	string (4)	ICAO type designator (A20N, B77W): the lookup key.
manufacturer / model	string	AIRBUS, Airbus A320 Neo.
num_engines	integer	Engine count.
wake_turbulence_category	string	Light, Light/Medium, Medium, Heavy or Super.

Data Sources

The FAA (U.S. Federal Aviation Administration) Aircraft Characteristics Database (public domain), OpenTravelData (CC BY 4.0 — credit it if you display its data) and OurAirports (CC0). GET /v1/reference/sources lists each source with its licence and status.