{"openapi":"3.1.0","info":{"title":"Airports Reference","version":"1.0.0","description":"Airport lookup, nearest airports, distances, runways and hubs from OurAirports open data. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"Airports Reference: Airport lookup, nearest airports, distances, runways and hubs from OurAirports open data. Use /airport-lookup for an airport by IATA, ICAO or fuzzy name, /airports-near for the nearest airports to a coordinate, /airport-distance for great-circle distance and a rough flight time between two airports, /airports-in for a country or region with a type filter, /airport-runways for runway facts, /airport-code-convert for IATA and ICAO conversion and validation, /airport-timezone for time zone availability, and /big-hubs for the largest airports. Each paid GET returns a computed verdict with the reasons, the source and what was NOT checked. A verdict of UNVERIFIED means a lookup failed: treat it as unknown. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://airports-reference.x402tookit.com"}],"paths":{"/airport-code-convert":{"get":{"operationId":"airport_code_convert","summary":"Convert an airport code between IATA (3 letters) and ICAO (4 letters) and validate the format; reports unknown codes.","description":"Convert an airport code between IATA (3 letters) and ICAO (4 letters) and validate the format; reports unknown codes.","tags":["iata","icao","airports","validate","convert"],"parameters":[{"name":"code","in":"query","required":true,"description":"An IATA (LHR) or ICAO (EGLL) airport code","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"input":{"type":["null","string"]},"inputKind":{"type":["null","string"]},"formatValid":{"type":["boolean","null"]},"icao":{"type":["null","string"]},"iata":{"type":["null","string"]},"airport":{"type":["null","object"],"properties":{"ident":{"type":["null","string"]},"name":{"type":["null","string"]},"iata":{"type":["null","string"]},"icao":{"type":["null","string"]},"type":{"type":["null","string"]},"municipality":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"region":{"type":["null","string"]},"regionName":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"elevationFt":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"scheduledService":{"type":["boolean","null"]}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CONVERTED","summary":"ICAO EGLL = IATA LHR (London Heathrow Airport).","reasons":[],"input":"EGLL","inputKind":"ICAO","formatValid":true,"icao":"EGLL","iata":"LHR","airport":{"ident":"EGLL","name":"London Heathrow Airport","iata":"LHR","icao":"EGLL","type":"large_airport","municipality":"London","country":"GB","countryName":"United Kingdom","region":"GB-ENG","regionName":"England","lat":51.47075,"lon":-0.45991,"elevationFt":83,"elevationM":25,"scheduledService":true},"attribution":"Airport data: OurAirports.com (public domain), built 2026-10-11; checked against Wikidata (CC0). No guarantee of accuracy.","degraded":false,"notChecked":["codes of airports outside the dataset (small fields, heliports, closed airports)","city codes that cover several airports (for example NYC, LON), which are not airport codes","…1 more"],"source":"OurAirports (public domain) cross-checked against Wikidata","asOf":"2026-10-11T09:02:11.047Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-code-convert"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-code-convert"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-code-convert"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-code-convert"}}]}}},"/airport-distance":{"get":{"operationId":"airport_distance","summary":"Great-circle distance in km, miles and nautical miles between two airports, with a rough flight time estimate.","description":"Great-circle distance in km, miles and nautical miles between two airports, with a rough flight time estimate.","tags":["airports","distance","great-circle","flight-time"],"parameters":[{"name":"from","in":"query","required":true,"description":"Origin airport: IATA, ICAO or name","schema":{"type":"string"}},{"name":"to","in":"query","required":true,"description":"Destination airport: IATA, ICAO or name","schema":{"type":"string"}},{"name":"speedKmh","in":"query","required":false,"description":"Assumed average cruise speed 300 to 1000 km/h (default 850)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"from":{"type":["null","object"],"properties":{"ident":{"type":["null","string"]},"name":{"type":["null","string"]},"iata":{"type":["null","string"]},"icao":{"type":["null","string"]},"type":{"type":["null","string"]},"municipality":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"region":{"type":["null","string"]},"regionName":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"elevationFt":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"scheduledService":{"type":["boolean","null"]}}},"to":{"type":["null","object"],"properties":{"ident":{"type":["null","string"]},"name":{"type":["null","string"]},"iata":{"type":["null","string"]},"icao":{"type":["null","string"]},"type":{"type":["null","string"]},"municipality":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"region":{"type":["null","string"]},"regionName":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"elevationFt":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"scheduledService":{"type":["boolean","null"]}}},"distanceKm":{"type":["null","number"]},"distanceMiles":{"type":["null","number"]},"distanceNauticalMiles":{"type":["null","number"]},"initialBearingDeg":{"type":["null","number"]},"estimate":{"type":["null","object"],"properties":{"minutes":{"type":["null","number"]},"hoursMinutes":{"type":["null","string"]},"assumedSpeedKmh":{"type":["null","number"]},"overheadMinutes":{"type":["null","number"]}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"ESTIMATED","summary":"JFK to LHR: 5,540 km (3,442 mi, 2,991 nm) great-circle, about 7 h 01 min gate-to-gate estimate.","reasons":["Assumption: average 850 km/h along the great circle plus a fixed 30 minutes for taxi, climb and approach. Not a schedule."],"from":{"ident":"KJFK","name":"John F. Kennedy International Airport","iata":"JFK","icao":"KJFK","type":"large_airport","municipality":"New York","country":"US","countryName":"United States","region":"US-NY","regionName":"New York","lat":40.63945,"lon":-73.77932,"elevationFt":13,"elevationM":4,"scheduledService":true},"to":{"ident":"EGLL","name":"London Heathrow Airport","iata":"LHR","icao":"EGLL","type":"large_airport","municipality":"London","country":"GB","countryName":"United Kingdom","region":"GB-ENG","regionName":"England","lat":51.47075,"lon":-0.45991,"elevationFt":83,"elevationM":25,"scheduledService":true},"distanceKm":5539.8,"distanceMiles":3442.3,"distanceNauticalMiles":2991.3,"initialBearingDeg":51,"estimate":{"minutes":421,"hoursMinutes":"7 h 01 min","assumedSpeedKmh":850,"overheadMinutes":30},"attribution":"Airport data: OurAirports.com (public domain), built 2026-10-11; checked against Wikidata (CC0). No guarantee of accuracy.","degraded":false,"notChecked":["the real route (airways, winds, detours and holding make real flights longer or shorter)","schedules, aircraft type, climb and descent profiles","…1 more"],"source":"OurAirports (public domain) cross-checked against Wikidata","asOf":"2026-10-11T09:02:11.322Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-distance"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-distance"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-distance"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-distance"}}]}}},"/airport-lookup":{"get":{"operationId":"airport_lookup","summary":"Find an airport by IATA code, ICAO code or name with fuzzy matching: location, elevation, type, longest runway.","description":"Find an airport by IATA code, ICAO code or name with fuzzy matching: location, elevation, type, longest runway.","tags":["airports","iata","icao","lookup"],"parameters":[{"name":"q","in":"query","required":true,"description":"IATA (JFK), ICAO (KJFK) or name (Heathrow, Kennedy Intl)","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Optional ISO country code or name to narrow a name search","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"input":{"type":["null","string"]},"matches":{"type":["array","null"],"items":{"type":"object","properties":{"ident":{"type":["null","string"]},"name":{"type":["null","string"]},"iata":{"type":["null","string"]},"icao":{"type":["null","string"]},"type":{"type":["null","string"]},"municipality":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"region":{"type":["null","string"]},"regionName":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"elevationFt":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"scheduledService":{"type":["boolean","null"]},"score":{"type":["null","number"]},"matchedOn":{"type":["null","string"]},"longestRunwayFt":{"type":["null","number"]},"wikipedia":{"type":["null","string"]}}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FUZZY_MATCH","summary":"London Heathrow Airport: IATA LHR, ICAO EGLL, London, elevation 83 ft.","reasons":["Approximate match on the name: confirm before relying on it."],"input":"Heathrow","matches":[{"ident":"EGLL","name":"London Heathrow Airport","iata":"LHR","icao":"EGLL","type":"large_airport","municipality":"London","country":"GB","countryName":"United Kingdom","region":"GB-ENG","regionName":"England","lat":51.47075,"lon":-0.45991,"elevationFt":83,"elevationM":25,"scheduledService":true,"score":0.8500000000000001,"matchedOn":"all words appear in name or city","longestRunwayFt":12799,"wikipedia":"https://en.wikipedia.org/wiki/Heathrow_Airport"}],"attribution":"Airport data: OurAirports.com (public domain), built 2026-10-11; checked against Wikidata (CC0). No guarantee of accuracy.","degraded":false,"notChecked":["airports outside the dataset (heliports, seaplane bases, small unscheduled strips and closed fields are not included)","current operating status, hours or restrictions","…1 more"],"source":"OurAirports (public domain) cross-checked against Wikidata","asOf":"2026-10-11T09:02:11.593Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-lookup"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-lookup"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-lookup"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-lookup"}}]}}},"/airport-runways":{"get":{"operationId":"airport_runways","summary":"Runway facts for an airport by IATA, ICAO or name: longest runway, surface, lighting, headings, closed runways.","description":"Runway facts for an airport by IATA, ICAO or name: longest runway, surface, lighting, headings, closed runways.","tags":["airports","runways","aviation"],"parameters":[{"name":"q","in":"query","required":true,"description":"IATA, ICAO or airport name, e.g. DEN","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"airport":{"type":["null","object"],"properties":{"ident":{"type":["null","string"]},"name":{"type":["null","string"]},"iata":{"type":["null","string"]},"icao":{"type":["null","string"]},"type":{"type":["null","string"]},"municipality":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"region":{"type":["null","string"]},"regionName":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"elevationFt":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"scheduledService":{"type":["boolean","null"]}}},"runwayCount":{"type":["null","number"]},"openRunwayCount":{"type":["null","number"]},"longestOpenRunway":{"type":["null","object"],"properties":{"lengthFt":{"type":["null","number"]},"widthFt":{"type":["null","number"]},"surface":{"type":["null","string"]},"lighted":{"type":["boolean","null"]},"closed":{"type":["boolean","null"]},"leIdent":{"type":["null","string"]},"heIdent":{"type":["null","string"]},"leHeadingTrueDeg":{"type":["null","number"]},"heHeadingTrueDeg":{"type":["null","number"]},"lengthM":{"type":["null","number"]},"paved":{"type":["boolean","null"]},"designators":{"type":["null","string"]}}},"anyLighted":{"type":["boolean","null"]},"runways":{"type":["array","null"],"items":{"type":"object","properties":{"lengthFt":{"type":["null","number"]},"widthFt":{"type":["null","number"]},"surface":{"type":["null","string"]},"lighted":{"type":["boolean","null"]},"closed":{"type":["boolean","null"]},"leIdent":{"type":["null","string"]},"heIdent":{"type":["null","string"]},"leHeadingTrueDeg":{"type":["null","number"]},"heHeadingTrueDeg":{"type":["null","number"]},"lengthM":{"type":["null","number"]},"paved":{"type":["boolean","null"]}}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"DEN: 6 runways; longest 16R/34L, 16,000 ft (4,877 m), surface CON.","reasons":["Surface codes are OurAirports' free text (ASP/ASPH asphalt, CON/CONC concrete, GRS/GRASS grass, GRVL gravel, TURF, DIRT, WATER, ...): not normalised."],"airport":{"ident":"KDEN","name":"Denver International Airport","iata":"DEN","icao":"KDEN","type":"large_airport","municipality":"Denver","country":"US","countryName":"United States","region":"US-CO","regionName":"Colorado","lat":39.86003,"lon":-104.67379,"elevationFt":5431,"elevationM":1655,"scheduledService":true},"runwayCount":6,"openRunwayCount":6,"longestOpenRunway":{"lengthFt":16000,"widthFt":200,"surface":"CON","lighted":true,"closed":false,"leIdent":"16R","heIdent":"34L","leHeadingTrueDeg":180.5,"heHeadingTrueDeg":0.5,"lengthM":4877,"paved":true,"designators":"16R/34L"},"anyLighted":true,"runways":[{"lengthFt":12000,"widthFt":150,"surface":"CON","lighted":true,"closed":false,"leIdent":"07","heIdent":"25","leHeadingTrueDeg":90.5,"heHeadingTrueDeg":270.5,"lengthM":3658,"paved":true},{"lengthFt":12000,"widthFt":150,"surface":"CON","lighted":true,"closed":false,"leIdent":"08","heIdent":"26","leHeadingTrueDeg":90.5,"heHeadingTrueDeg":270.5,"lengthM":3658,"paved":true}],"attribution":"Airport data: OurAirports.com (public domain), built 2026-10-11; checked against Wikidata (CC0). No guarantee of accuracy.","degraded":false,"notChecked":["runway condition, displaced thresholds, declared distances or weight limits","whether the longest runway suits a given aircraft","…1 more"],"source":"OurAirports (public domain) cross-checked against Wikidata","asOf":"2026-10-11T09:02:11.856Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-runways"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-runways"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-runways"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-runways"}}]}}},"/airport-timezone":{"get":{"operationId":"airport_timezone","summary":"Time zone offset of an airport: reports whether the dataset has one (it does not) and gives a nominal solar offset.","description":"Time zone offset of an airport: reports whether the dataset has one (it does not) and gives a nominal solar offset.","tags":["airports","timezone","utc-offset"],"parameters":[{"name":"q","in":"query","required":true,"description":"IATA, ICAO or airport name, e.g. SYD","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"airport":{"type":["null","object"],"properties":{"ident":{"type":["null","string"]},"name":{"type":["null","string"]},"iata":{"type":["null","string"]},"icao":{"type":["null","string"]},"type":{"type":["null","string"]},"municipality":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"region":{"type":["null","string"]},"regionName":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"elevationFt":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"scheduledService":{"type":["boolean","null"]}}},"timezone":{},"utcOffsetHours":{},"nominalSolarOffsetHours":{"type":["null","number"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"TIMEZONE_UNAVAILABLE","summary":"OurAirports has no time zone for Sydney Kingsford Smith International Airport (SYD); only a nominal solar offset of UTC+10.1 h from longitude 151.177 is computed.","reasons":["The nominal solar offset is longitude divided by 15 degrees per hour. It is NOT the legal time zone: countries use one zone across wide areas, and daylight saving shifts it."],"airport":{"ident":"YSSY","name":"Sydney Kingsford Smith International Airport","iata":"SYD","icao":"YSSY","type":"large_airport","municipality":"Sydney (Mascot)","country":"AU","countryName":"Australia","region":"AU-NSW","regionName":"New South Wales","lat":-33.9461,"lon":151.177,"elevationFt":21,"elevationM":6,"scheduledService":true},"timezone":null,"utcOffsetHours":null,"nominalSolarOffsetHours":10.1,"attribution":"Airport data: OurAirports.com (public domain), built 2026-10-11; checked against Wikidata (CC0). No guarantee of accuracy.","degraded":false,"notChecked":["the legal time zone, daylight saving rules or UTC offset (the dataset has no time zone field)","political changes to time zones","…1 more"],"source":"OurAirports (public domain) cross-checked against Wikidata","asOf":"2026-10-11T09:02:12.117Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-timezone"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-timezone"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-timezone"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airport-timezone"}}]}}},"/airports-in":{"get":{"operationId":"airports_in","summary":"List airports in a country or ISO region (like US-CO) filtered by size and scheduled service, with codes.","description":"List airports in a country or ISO region (like US-CO) filtered by size and scheduled service, with codes.","tags":["airports","country","region","list"],"parameters":[{"name":"country","in":"query","required":true,"description":"ISO country code or name, e.g. NZ or New Zealand","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"Optional ISO 3166-2 region, e.g. US-CO","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"any (default), large, medium or small: that size or bigger","schema":{"type":"string"}},{"name":"scheduled","in":"query","required":false,"description":"true to list only airports with scheduled service","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results 1 to 100 (default 25)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"region":{},"total":{"type":["null","number"]},"counts":{"type":["null","object"],"properties":{"large":{"type":["null","number"]},"medium":{"type":["null","number"]},"small":{"type":["null","number"]}}},"airports":{"type":["array","null"],"items":{"type":"object","properties":{"ident":{"type":["null","string"]},"name":{"type":["null","string"]},"iata":{"type":["null","string"]},"icao":{"type":["null","string"]},"type":{"type":["null","string"]},"municipality":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"region":{"type":["null","string"]},"regionName":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"elevationFt":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"scheduledService":{"type":["boolean","null"]}}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"38 airports in New Zealand: 4 large, 34 medium, 0 small; showing 10.","reasons":["Showing the first 10 of 38."],"country":"NZ","countryName":"New Zealand","region":null,"total":38,"counts":{"large":4,"medium":34,"small":0},"airports":[{"ident":"NZAA","name":"Auckland International Airport","iata":"AKL","icao":"NZAA","type":"large_airport","municipality":"Auckland","country":"NZ","countryName":"New Zealand","region":"NZ-AUK","regionName":"Auckland Region","lat":-37.01199,"lon":174.78633,"elevationFt":23,"elevationM":7,"scheduledService":true},{"ident":"NZCH","name":"Christchurch International Airport","iata":"CHC","icao":"NZCH","type":"large_airport","municipality":"Christchurch","country":"NZ","countryName":"New Zealand","region":"NZ-CAN","regionName":"Canterbury Region","lat":-43.48903,"lon":172.53207,"elevationFt":123,"elevationM":37,"scheduledService":true}],"attribution":"Airport data: OurAirports.com (public domain), built 2026-10-11; checked against Wikidata (CC0). No guarantee of accuracy.","degraded":false,"notChecked":["airports outside the dataset (heliports, seaplane bases, small unscheduled strips, closed fields)","passenger traffic (order is by size class, then name)","…1 more"],"source":"OurAirports (public domain) cross-checked against Wikidata","asOf":"2026-10-11T09:02:12.375Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airports-in"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airports-in"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airports-in"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airports-in"}}]}}},"/airports-near":{"get":{"operationId":"airports_near","summary":"Nearest airports to a latitude and longitude with distance, bearing, type and codes; filter by size or scheduled service.","description":"Nearest airports to a latitude and longitude with distance, bearing, type and codes; filter by size or scheduled service.","tags":["airports","nearest","geo"],"parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude, -90 to 90","schema":{"type":"number"}},{"name":"lon","in":"query","required":true,"description":"Longitude, -180 to 180","schema":{"type":"number"}},{"name":"radiusKm","in":"query","required":false,"description":"Search radius 1 to 1000 km (default 150)","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Results 1 to 25 (default 10)","schema":{"type":"integer"}},{"name":"type","in":"query","required":false,"description":"any (default), large, medium or small: that size or bigger","schema":{"type":"string"}},{"name":"scheduled","in":"query","required":false,"description":"true to list only airports with scheduled service","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"query":{"type":["null","object"],"properties":{"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"radiusKm":{"type":["null","number"]},"type":{"type":["null","string"]},"scheduledOnly":{"type":["boolean","null"]}}},"airports":{"type":["array","null"],"items":{"type":"object","properties":{"ident":{"type":["null","string"]},"name":{"type":["null","string"]},"iata":{"type":["null","string"]},"icao":{"type":["null","string"]},"type":{"type":["null","string"]},"municipality":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"region":{"type":["null","string"]},"regionName":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"elevationFt":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"scheduledService":{"type":["boolean","null"]},"distanceKm":{"type":["null","number"]},"distanceNm":{"type":["null","number"]},"bearingFromPointDeg":{"type":["null","number"]}}}},"totalWithinRadius":{"type":["null","number"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"Nearest: LaGuardia Airport (LGA), 13.3 km away; 3 within 100 km.","reasons":["Distances are great-circle on a sphere of radius 6371.0088 km."],"query":{"lat":40.7128,"lon":-74.006,"radiusKm":100,"type":"large","scheduledOnly":false},"airports":[{"ident":"KLGA","name":"LaGuardia Airport","iata":"LGA","icao":"KLGA","type":"large_airport","municipality":"New York","country":"US","countryName":"United States","region":"US-NY","regionName":"New York","lat":40.7772,"lon":-73.8726,"elevationFt":21,"elevationM":6,"scheduledService":true,"distanceKm":13.3,"distanceNm":7.2,"bearingFromPointDeg":57},{"ident":"KEWR","name":"Newark Liberty International Airport","iata":"EWR","icao":"KEWR","type":"large_airport","municipality":"Newark","country":"US","countryName":"United States","region":"US-NJ","regionName":"New Jersey","lat":40.6894,"lon":-74.17054,"elevationFt":18,"elevationM":5,"scheduledService":true,"distanceKm":14.1,"distanceNm":7.6,"bearingFromPointDeg":259}],"totalWithinRadius":3,"attribution":"Airport data: OurAirports.com (public domain), built 2026-10-11; checked against Wikidata (CC0). No guarantee of accuracy.","degraded":false,"notChecked":["airports not in the dataset (heliports, seaplane bases, small unscheduled strips, closed fields)","road or flight route distance (this is straight-line great-circle distance)","…1 more"],"source":"OurAirports (public domain) cross-checked against Wikidata","asOf":"2026-10-11T09:02:12.640Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airports-near"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airports-near"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airports-near"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/airports-near"}}]}}},"/big-hubs":{"get":{"operationId":"big_hubs","summary":"Busiest large airports ranked by annual passengers (latest Wikidata figure), optionally by country or continent.","description":"Busiest large airports ranked by annual passengers (latest Wikidata figure), optionally by country or continent.","tags":["airports","hubs","passengers","ranking"],"parameters":[{"name":"country","in":"query","required":false,"description":"Optional ISO country code or name","schema":{"type":"string"}},{"name":"continent","in":"query","required":false,"description":"Optional continent code: AF AN AS EU NA OC SA","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results 1 to 50 (default 15)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"filter":{"type":["null","object"],"properties":{"country":{},"continent":{"type":["null","string"]}}},"rankedAirports":{"type":["null","number"]},"airports":{"type":["array","null"],"items":{"type":"object","properties":{"rank":{"type":["null","number"]},"ident":{"type":["null","string"]},"name":{"type":["null","string"]},"iata":{"type":["null","string"]},"icao":{"type":["null","string"]},"type":{"type":["null","string"]},"municipality":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"region":{"type":["null","string"]},"regionName":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"elevationFt":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"scheduledService":{"type":["boolean","null"]},"passengers":{"type":["null","number"]},"passengersYear":{"type":["null","number"]}}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"RANKED","summary":"Top 5 in EU: IST 84M (2025), LHR 84M (2024), CDG 67M (2023).","reasons":["The figures come from different years (shown per airport), so close ranks may be out of order for a single year.","Passenger figures are Wikidata's latest value with a date, not an official ranking."],"filter":{"country":null,"continent":"EU"},"rankedAirports":174,"airports":[{"rank":1,"ident":"LTFM","name":"İstanbul Airport","iata":"IST","icao":"LTFM","type":"large_airport","municipality":"Istanbul","country":"TR","countryName":"Turkey","region":"TR-34","regionName":"İstanbul Province","lat":41.27487,"lon":28.73214,"elevationFt":325,"elevationM":99,"scheduledService":true,"passengers":84457421,"passengersYear":2025},{"rank":2,"ident":"EGLL","name":"London Heathrow Airport","iata":"LHR","icao":"EGLL","type":"large_airport","municipality":"London","country":"GB","countryName":"United Kingdom","region":"GB-ENG","regionName":"England","lat":51.47075,"lon":-0.45991,"elevationFt":83,"elevationM":25,"scheduledService":true,"passengers":83884572,"passengersYear":2024}],"attribution":"Airport data: OurAirports.com (public domain), built 2026-10-11; checked against Wikidata (CC0). No guarantee of accuracy.","degraded":false,"notChecked":["airports with no passenger figure in Wikidata (about 45% of large airports with IATA codes are missing, so a missing airport is not necessarily small)","that the figures are for the same year: each airport shows its own latest year","…1 more"],"source":"OurAirports (public domain) cross-checked against Wikidata","asOf":"2026-10-11T09:02:12.896Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/big-hubs"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/big-hubs"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/big-hubs"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://airports-reference.x402tookit.com/big-hubs"}}]}}}}}