API Documentation

Official REST API endpoints for airport-data.com datasets.

Airport-Data.com offers lightweight JSON API endpoints designed for high-performance programmatic access to aircraft and airport datasets.

Aircraft Thumbnail

Endpoint

GET https://airport-data.com/api/ac_thumb.json?m={mode_s}&n={count}

Query Parameters

Parameter	Type	Required	Description
m	Hex String	Yes	6-character Mode-S code.
n	Integer	No	Maximum results (Default: 1).
r	String	No	Aircraft registration.

Sample Response

{
  "status": 200,
  "count": 2,
  "data": [
    {
      "image": "https://airport-data.com/images/aircraft/thumbnails/000/582/582407.jpg",
      "link": "https://airport-data.com/aircraft/photo/000582407",
      "photographer": "Jan Ittensammer"
    },
    {
      "image": "https://airport-data.com/images/aircraft/thumbnails/000/560/560416.jpg",
      "link": "https://airport-data.com/aircraft/photo/000560416",
      "photographer": "Shunn311"
    }
  ]
}

Aircraft Info

Endpoint

GET https://airport-data.com/api/ac_info.json?m={mode_s}

Response Fields

Field	Type	Description
reg	String	Registration identifier.
model	String	Manufacturer and model.
cn	String	Constructor (serial) number.
country	String	Registered country.
mode_s_code	String	Mode-S hex code used for the lookup.
link	String	Link to the aircraft profile page.

Airport Info

Endpoint - Search by ICAO

GET https://airport-data.com/api/ap_info.json?icao={icao}

Endpoint - Search by IATA

GET https://airport-data.com/api/ap_info.json?iata={iata}

Sample Response

{
  "icao": "KJFK",
  "iata": "JFK",
  "name": "John F Kennedy International Airport",
  "location": "New York, NY",
  "country": "United States",
  "country_code": "US",
  "longitude": "-73.778926",
  "latitude": "40.639751",
  "link": "https://airport-data.com/airport/JFK/",
  "status": 200
}

Status Codes

Standard HTTP response codes used to indicate request success or failure.

Code	Status	Description
200	OK	The request was successful.
400	Bad Request	Invalid query parameters.
404	Not Found	Resource could not be found.
429	Limited	Rate limit exceeded.
500	Error	Internal server error.