Airports API

Look up 12 000 airports by IATA / ICAO code, name or city, find the nearest airports, and get the distance and bearing between two airports.

GEThttps://apibox.io.vn/v1/airports

Data & JSON▶ Try it online

/v1/airports/SGN (or iata=, icao=, code=) returns one airport: name, type, city, country, region, coordinates, elevation, scheduled service, codes and, for large and medium airports, the open runways (ends, length, width, surface, lighting). q searches names, cities and known alternate names without accents (saigon finds Tân Sơn Nhất); filter with country, type (large, medium, small, seaplane) and scheduled=true.

lat + lon lists the nearest airports (by default large, medium and small airports that have an IATA code) with their distance; from + to returns the great-circle distance in km, miles and nautical miles and the initial and final bearing.

Data: OurAirports (public domain), refreshed weekly: all large and medium airports, plus small airports and seaplane bases that have an IATA or ICAO code; closed airports and heliports are left out. Distances are on a sphere, within about 0.5 % of the ellipsoid distance – fine for display and estimates, not for flight planning.

Parameters

Name	In	Type	Required	Default
`code`	path	string	no		IATA (3 letters) or ICAO (4 letters) code: `/v1/airports/HAN`. Also `iata=`, `icao=`, `code=`.
`q`	query	string	no		Name, city or code to search.
`lat`	query	number	no		Latitude for the nearest airports (with `lon`).
`lon`	query	number	no		Longitude.
`from`	query	string	no		Origin airport code for a distance (with `to`).
`to`	query	string	no		Destination airport code.
`country`	query	string	no		ISO country filter, e.g. `VN`.
`type`	query	string	no		`large`, `medium`, `small`, `seaplane` (comma-separated).
`scheduled`	query	boolean	no		Only airports with (true) or without (false) scheduled flights.
`limit`	query	number	no	`10`	Results (1–50).

Example

curl "https://apibox.io.vn/v1/airports?from=SGN&to=NRT" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/airports?from=SGN&to=NRT', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
});
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://apibox.io.vn/v1/airports?from=SGN&to=NRT",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/airports?from=SGN&to=NRT');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Response

{
  "from": {
    "iata": "SGN",
    "icao": "VVTS",
    "ident": "VVTS",
    "name": "Tan Son Nhat International Airport",
    "type": "large_airport",
    "municipality": "Ho Chi Minh City",
    "country_code": "VN",
    "country": "Vietnam",
    "region_code": "VN-SE",
    "lat": 10.8188,
    "lon": 106.652,
    "elevation_ft": 33,
    "elevation_m": 10,
    "scheduled_service": true
  },
  "to": {
    "iata": "NRT",
    "icao": "RJAA",
    "ident": "RJAA",
    "name": "Narita International Airport",
    "type": "large_airport",
    "municipality": "Narita",
    "country_code": "JP",
    "country": "Japan",
    "region_code": "JP-12",
    "lat": 35.76858,
    "lon": 140.38871,
    "elevation_ft": 141,
    "elevation_m": 43,
    "scheduled_service": true
  },
  "distance": {
    "km": 4383.7,
    "mi": 2723.9,
    "nmi": 2367
  },
  "initial_bearing": 45.2,
  "initial_bearing_compass": "NE",
  "final_bearing": 59.2,
  "method": "great-circle (haversine) distance on a sphere of radius 6371.0088 km; bearings in degrees from true north",
  "attribution": "Data: OurAirports (ourairports.com), public domain",
  "data_version": "2026-11-11"
}

Use cases

Airport picker with IATA codes for a booking or travel form
Find the closest airport to a hotel or event venue
Show flight distance between two airports for loyalty miles or CO₂ estimates
Check runway length of an airport for a charter request

FAQ

Is the data free to reuse?

Yes. OurAirports releases its data into the public domain; a credit is appreciated but not required.

Why is a small airfield missing?

Small airports are kept only when they have an IATA or ICAO code. Heliports and closed airports are dropped.

Is the distance the flown distance?

No. It is the shortest great-circle distance between the two airports; real routes are longer because of airways and weather.

Related APIs

{✓}

Airports API

Parameters

Example

Response

Use cases

FAQ

Related APIs

JSON Validator

JSON Formatter

CSV to JSON