Flight Time & Route Calculator
Endpoint to retrieve flight time, flight route & fuel usage.
Request body
Departure airport ICAO code / IATA code / Local identifier or coordinates. e.g. "LSGG", "RIX", "39.7841944444 -104.537638889"
Arrival airport ICAO code / IATA code / Local identifier or coordinates. e.g. "KJFK", "BCA", "8.45991666667 48.5683611111
Aircraft profile name / ICAO code / type. Profile name is preferable. e.g. "HondaJet (IASA regulations)", "CL60", "Global 6000"
Aircraft tail number. Helps find exact aircraft profile. Overrides 'aircraft' parameter if found in Aviapages database.
Local time of departure in format "YYYY-MM-DDThh:mm". Default: current UTC datetime. e.g. "2020-10-28T12:00"
Number of passengers.
Custom payload parameter, kg. Overrides pax parameter.
Display local arrival date & time depending on time calculation methods selected from above ("airway_time", "airway_time_weather_impacted", "great_circle_time", "average_speed_time" will return "arrival_local_airway", "arrival_local_airway_weather_impacted", "arrival_local_great_circle", "arrival_local_average_speed" respectively)
Calculate great circle route (shortest distance) as an array of coordinates between airports
Calculate carbon dioxide emissions via great circle using aircraft performance model, kg
Calculate carbon dioxide emissions via airways using aircraft performance model, kg
Calculate carbon dioxide emissions via airways using aircraft performance model with historical average wind, kg
Calculate distance between airports via great circle (shortest distance).
Calculate flight time via great circle (shortest distance) using aircraft performance model.
Calculate trip and block fuel via great circle using aircraft performance model.
Calculate flight time via great circle using aircraft's average speed constant. Simplest and fastest calculations.
Calculate airway route of coordinates between airports via airways.
Calculate flight time via airways using aircraft performance model.
Calculate distance between airports via airways.
Calculate flight time via airways using aircraft performance model with historical average wind impact. This is the recommended method for most accurate result.
Calculate trip and block fuel via great circle using aircraft performance model with historical average wind.
Calculate trip and block fuel via airways using aircraft performance model.
Advise optimal airports for tech stop in case direct flight is not possible.
Calculate route as a sequence of airways and airway points used for en-route navigation.
Calculate and display detailed breakdown of fuel consumption via airways using aircraft performance model with historical average wind.
Calculate and display detailed breakdown of fuel consumption via airways using aircraft performance model.
Calculate and display detailed breakdown of fuel consumption via great circle using aircraft performance model.
Use historical average wind for airway calculations. This is the recommended method for most accurate result.
List of countries to avoid in airway calculations. e.g. ["Iran", "Syria"], ["UKR", "BLR"] or ["BY", "UA"]
List of FIR to avoid in airway calculations. e.g. ["UKDV", "UKBV"]
Use ETOPS in airway calculations. Possible values: "ETOPS90", "ETOPS120", "ETOPS180".
Set custom user tag. Helpful for debugging or logging.
Aircraft's aerodynamic and flight characteristics degradation factor, percent.
Custom aircraft's operating empty weight, kg.
Custom aircraft's maximum takeoff weight, kg.
Custom aircraft's zero fuel weight, kg.
Custom aircraft's max fuel weight, kg.
Custom aircraft's taxi fuel weight, kg.
Custom aircraft's alternate fuel weight, kg.
Custom aircraft's holding fuel weight, kg.
Custom aircraft's contingency fuel weight, kg.
Custom aircraft's extra fuel weight, kg.
Custom aircraft's optimal flight level, m.
Custom aircraft's cruise speed. e.g. "M0.80", "M0.85", "M0.90", "M0.95", "M0.99"
Custom aircraft's maximum landing weight, kg.
Custom aircraft's maximum zero fuel weight, kg.
Show FIRs crossed during the route
Show countries crossed during the route
Total runway taxi time, minutes.
Automatic "efficiency mode": if the initial calculation fails due to weight or fuel constraints, the system recalculates the flight using the most fuel-efficient flight mode.
The calculation will be performed using the most efficient performance mode. Custom speed and altitude parameters will be ignored.
Flight time adjustment in minutes applied to the calculated flight duration; may be positive or negative.
Response
Aircraft profile name.
Carbon dioxide emissions via great circle using aircraft performance model in kilograms.
Carbon dioxide emissions via airways using aircraft performance model in kilograms.
Carbon dioxide emissions via airways using aircraft performance model with historical average wind in kilograms.
Changes
No recorded changes to this endpoint across all 1 revision of this API.