Tools (43)
Get single aircraft (by tail-number, Mode-S or ID)
Returns: Single aircraft, best matching specified search criteria, if found
Flight status (specific date)
Gets information about the status of the nearest (either in past or in future) flight or about flight departing or arriving on the day specified (local time), operated:
- under specified flight number; or
- by an aircraft with specified registration; or
- under specified ATC-callsign; or
- by an aircraft with specified Mode-S 24-bit ICAO Transponder address.
Search airports by free text
Gets the list of airports with ICAO or IATA code matching the search term case-insensitively and airports with airport or city name containing the search term case-insensitively.
All countries
Returns the list of all countries in the database
Airport data feed services status by ICAO code
Gets current status of airport data feed services (live flight updates, flight schedules, etc.) for requested airport.
Current local time at the airport
What is the current local time at the airport?
Flight departure dates
**On which days the flight operates?** or **What is the flight schedule?**
Get flight departure dates for a flight operated:
, operated:
- under specified flight number; or
- by an aircraft with specified registration; or
- under specified ATC-callsign; or
- by an aircraft with specified Mode-S 24-bit ICAO Transponder address.
Returns: Array of local departure dates in (YYYY-MM-DD).
Airports supporting data feed service
**Which airports support flight schedules? **or **Which airports support live flight updates?**
Returns: Collection ICAO codes of airports supporting specified airport data feed service.
[DEPRECATED] Search airports by location (path-style)
Use `Search airports by location` endpoint instead.
Get web-hook subscription
Gets information about an existing web-hook subscription.
Weather / forecast at the airport - current
- What is the current weather at the airport?
Get all aircraft (by tail-number, Mode-S or ID)
Returns: A list of all aircraft matching the search criteria
Flight status (nearest day)
Gets information about the status of the nearest (either in past or in future) flight or about flight departing or arriving on the day specified (local time), operated:
- under specified flight number; or
- by an aircraft with specified registration; or
- under specified ATC-callsign; or
- by an aircraft with specified Mode-S 24-bit ICAO Transponder address.
(BETA) Aircraft image by registration
**What is the aircraft photo? **
Aircraft images are being searched externally in Flickr. Only images with licenses approved for commercial use are returned. Please be advised that you may be required to mention author attribution before using the image.
Returns: Image data with medium-sized direct image URL and licence approved for commercial use is returned.
Aircraft registration history (by tail-number, Mode-S or ID)
Returns: A list of all known registrations of a single aircraft, best matching specified search criteria, if found
(BETA) Aircraft image recognition
**What aircrafts are depicted on this photo?**
This endpoint recognizes aircrafts on uploaded image and returns information about all detected aircrafts. It is based on computer vision technology and therefore results may be imprecise. It relies on detecting aircrafts' registrations and, once detected, attempting to match these registration with records in aircrafts database.
Returns: Data about found and recognized aircrafts.
General status of data feed services
**Which is the general health of the data feed service?**
Returns: Status of the service in general, regardless of the airports
Airport routes and daily flights statistics (by date)
**What are the most popular routes from an airport?** or **Where I can fly from an airport?** or **How many daily flights to different destinations from an airport?**
Gets list of routes and daily flights amount departing from an airport based on 7 days prior to selected date.
Flight delays - by flight number
**By how much the flight was delayed?**
Gets delay statistics for the flight with specified number.
Airport delays (by range of dates)
**What is the historical average delay in the airport?** or **How the delays changed within a specific period of time?**
Statistics are calculated against the flight data we aggregated. Henceforth, it is available only for those airports and those periods of time when delay information could have been reasonably derived. This applies to flights which qualify for this calculation (actual time and status of the flight must be available). This normally applies to flights arriving to / departing from the airports with Live or Radar + Scheduled quality. Learn more about coverage here: https://aerodatabox.com/data-coverage/
Median delay and delay index are available if there were at least 2 flights per hour per departures or arrivals at the time requested and at least 3 total qualifying flights within the coverage period.
*Returns*: Statistical delay information about delays (median delay, delay index, cancelled flights) of arrivals and departures for the requested airport, represented by a collection of `AiportDelayContract` items displaying the delay information at multiple moments within the period between `dateLocal` and `dateToLocal`, if both are specified.
Flight history & schedule (range of dates)
**What is the history or schedule of a specific flight within a specific range of dates in past or in future?**
This endpoint is the similar to the *Flight status* endpoints. The only difference is that instead of returning the flight data on a single day, it ** returns the list of flights operating within a selected range of dates.**
All limitations and considerations applicable to *Flight status* endpoint are applicable to this endpoint as well.
Refresh web-hook subscription
Refreshes an existing web-hook subscription
If the subscription had an expiration date-time set upon its creation, this endpoint will reset it in the following manner: e.g. if your subscription was set to expire in 7 days after creation, after refreshing the new expiration date-time will be set 7 days since the current moment.
If the subscription had no expiration date-time set, nothing occurs.
List web-hook subscriptions
Get the list of existing active web-hook subscriptions
Search flight numbers by term
Returns: Distinct list of available flight numbers which start with the search query.
Search airports by location
Gets the list of airports found within specified radius around specified location.
Create web-hook subscription
Creates a webhook subscription on a subject (e.g. flight by number or by airport code). Returns information about the created subscription. Subscription ID contained in it can be used to refresh or remove it.
Airport delays (current)
**What is the current average delay in the airport?*
Statistics are calculated against the flight data we aggregated. Henceforth, it is available only for those airports and those periods of time when delay information could have been reasonably derived. This applies to flights which qualify for this calculation (actual time and status of the flight must be available). This normally applies to flights arriving to / departing from the airports with Live or Radar + Scheduled quality. Learn more about coverage here: https://aerodatabox.com/data-coverage/
Median delay and delay index are available if there were at least 2 flights per hour per departures or arrivals at the time requested and at least 3 total qualifying flights within the coverage period.
*Returns*: Statistical delay information about delays (median delay, delay index, cancelled flights) of arrivals and departures for the requested airport, represented by a single `AirportDelayContract` item displaying the delay information based on flight movements within the 2 hours prior to the current moment, if no `dateLocal` is specified.
Search airports by IP address geolocation
**What are the airports closest to the customer, based on their IP address?**
** What are the airports closest to the location determined (geo-located) by a IP address?**
Gets the list of airports found within the specified radius around the location approximated (geo-located) from the specified IP address.
FAA LADD Aircraft Status
*Returns:* The **current** status of the specified aircraft in[ the Limiting Aircraft Displayed program of the Federal Aviation Administration of the U.S. Department of Transportation (FAA LADD)]( https://www.faa.gov/pilots/laddl).
**DISCLAIMER.** This endpoint is designed to provide easy access to verification against the FAA LADD industry list. Even though it is based on the official data distributed weekly by the FAA, this is **NOT an official source of the FAA LADD data**. For the official sources, always contact the FAA directly.
Global delays (current)
**What is the current delay situation in all airports?** or **What is the delay index of all airports right now ?**
*Returns:* Statistical delay information about delays (median delay, delay index, cancelled flights) of arrivals and departures for all known airports, represented by a collection of items sorted in departure index descending order (from worst to best).
Solar and day time at the airport
- What is the sun position in the sky now at a specific time at the airport?
- When does the sun rise and set at the airport today or on the other day at the airport?
- Is it dark now or is it day at the airport?
Weather / forecast at the airport - at specific time
- What is the weather forecast for the airport? (up to 48 hours ahead)
Search aircraft by term
Returns: List of active aircraft registrations with tail numbers starting from the term.
Remove web-hook subscription
Removes the subscription
Airport routes and daily flights statistics (current)
**What are the most popular routes from an airport?** or **Where I can fly from an airport?** or **How many daily flights to different destinations from an airport?**
Gets list of routes and daily flights amount departing from an airport based on 7 days prior to current local date.
Aiport by code
Gets airport by code (IATA or ICAO).
FIDS: Airport departures and arrivals (by time range)
**What are current departures or arrivals at the airport?** or **What is the flight schedule at the airport?** or **What is flight history at the airport?**
Flights may contain live updates with corresponding information related to the actual progress of the flight (including actual/estimated arrival/departure times). In this case this endpoint serves as a FIDS endpoint. Presense of live updates is subject to data coverage: not all airports have this coverage in our system.
Otherwise the flight information will be limited to schedule only and will not be updated with time. Much more airports have this coverage.
To check if airport is tracked and on which level, use `/health/services/airports/{icao}/feeds` endpoint. You can also use `/health/services/feeds/{service}/airports` to get the list of supported airports for this or that layer of coverage.
To learn more about the data coverage, refer to https://www.aerodatabox.com/data-coverage.
Returns: the list of arriving and/or departing flights scheduled and/or planned and/or commenced within a specified time range for a specified airport.
Global delays (by date)
**What is the historical delay situation in all airports?** or **What was the delay index of all airports at a moment in the past?**
*Returns:* Statistical delay information about delays (median delay, delay index, cancelled flights) of arrivals and departures for all known airports, represented by a collection of items sorted in departure index descending order (from worst to best).
Flight time & Distance between airports
**What is the great circle distance between airports?**
**What is approximate flight time between airports?**
**What is the flight time between airports based on history of flights and/or aircraft type?** (machine-learning based)
Use `flightTimeModel = ML01` to get more accurate results based on historical performance of flights on route and aircraft type.
Returns: Distance and approximate flight time between airports, if both airports found.
Airport delays (by date)
**What is the delay index at a moment in the past?""
Statistics are calculated against the flight data we aggregated. Henceforth, it is available only for those airports and those periods of time when delay information could have been reasonably derived. This applies to flights which qualify for this calculation (actual time and status of the flight must be available). This normally applies to flights arriving to / departing from the airports with Live or Radar + Scheduled quality. Learn more about coverage here: https://aerodatabox.com/data-coverage/
Median delay and delay index are available if there were at least 2 flights per hour per departures or arrivals at the time requested and at least 3 total qualifying flights within the coverage period.
*Returns*: Statistical delay information about delays (median delay, delay index, cancelled flights) of arrivals and departures for the requested airport, represented by a single `AirportDelayContract` item displaying the delay information based on flight movements within the 2 hours prior to the moment requested in `dateLocal`
Airport runways
Gets information about runways at specified airport.
FIDS: Airport departures and arrivals (by relative time)
**What are current departures or arrivals at the airport?** or **What is the flight schedule at the airport?** or **What is flight history at the airport?**
Flights may contain live updates with corresponding information related to the actual progress of the flight (including actual/estimated arrival/departure times). In this case this endpoint serves as a FIDS endpoint. Presense of live updates is subject to data coverage: not all airports have this coverage in our system.
Otherwise the flight information will be limited to schedule only and will not be updated with time. Much more airports have this coverage.
To check if airport is tracked and on which level, use `/health/services/airports/{icao}/feeds` endpoint. You can also use `/health/services/feeds/{service}/airports` to get the list of supported airports for this or that layer of coverage.
To learn more about the data coverage, refer to https://www.aerodatabox.com/data-coverage.
Returns: the list of arriving and/or departing flights scheduled and/or planned and/or commenced within a time range specified
relatively to the current local time at the airport.
(BETA) Airline fleet / Aircraft list by airline code
*Returns: * A paged list of aircraft in the fleet of the specified airline.
That will include active aircraft currently flying in an active airline, verfified through more than one source. Unconfirmed sightings of an aircraft will not qualify said aircraft to be listed in the fleet.