Aircraft API

Single aircraft registration history (by tail-number, Mode-S or ID) / TIER 1

Returns: A list of all known registrations of a single aircraft, best matching specified search criteria, if found

get/aircrafts/{searchBy}/{searchParam}/registrations

Request

  • Base URL: https://api.aerodatabox.com
  • URL: https://api.aerodatabox.com/aircrafts/{searchBy}/{searchParam}/registrations
  • Auth: API key in header X-Api-Key

Path parameters

searchBy'Id' | 'Reg' | 'Icao24' required

Criteria to search aircraft by<p>Possible values:</p>

<ul> <li><b>0 - Id</b>: ID of the aircraft (as stored in this API)</li> <li><b>1 - Reg</b>: Search by aircraft tail-number</li> <li><b>2 - Icao24</b>: Search by 24-bit ICAO Mode-S Transponder code</li> </ul>

Criteria to search aircraft by

searchParamstring required

Value of the search criteria. If searchBy is:

  • id, then this field should be an ID of an aircraft (as specified in the database of this API);
  • reg, then this field should be a tail-number of an aircraft (with or without spaces or dashes, any case formats are acceptable, e.g.PH-BXO, DeMhJ), multiple matches are possible - see below;
  • icao24, then this field should be a ICAO 24-bit Mode-S address of an aircraft specified in hexadecimal format (e.g. 484161, 483EFD), multiple matches are possible - see below.

If multiple matches are possible: see similar remark to Single aircraft endpoint.

Response

OK

regstring required

Tail-number of the aircraft

activeboolean required

Indicator if aircraft is operational under this registration

hexIcaostring nullable

ICAO 24 bit Mode-S hexadecimal transponder address

airlineNamestring nullable

Name of the airline operating the aircraft

registrationDatestring date-time nullable

Date of assigning current registration

Changes

No recorded changes to this operation across all 1 revision of this API.