API Documentation

API requests must use HTTPS. All data is returned in JSON format.

Aircraft Thumbnail

Endpoint

GET https://staging.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://staging.airport-data.com/images/aircraft/thumbnails/000/582/582407.jpg",
      "link": "https://staging.airport-data.com/aircraft/photo/000582407",
      "photographer": "Jan Ittensammer"
    },
    {
      "image": "https://staging.airport-data.com/images/aircraft/thumbnails/000/560/560416.jpg",
      "link": "https://staging.airport-data.com/aircraft/photo/000560416",
      "photographer": "Shunn311"
    }
  ]
}

Aircraft Info

Endpoint

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

Response Fields

Field	Type	Description
reg	String	Registration identifier.
model	String	Manufacturer and model.
icao_model	String	ICAO type code.
country	String	Registered country.

Airport Info

Endpoint - Search by ICAO

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

Endpoint - Search by IATA

GET https://staging.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://staging.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.