---
title: "Flight Time & Route Calculator"
method: POST
path: "/v3/flight_calculator/"
tags: ["flight_calculator"]
---

# Flight Time & Route Calculator

`POST /v3/flight_calculator/`

Endpoint to retrieve flight time, flight route & fuel usage.

## Request body

- FlightCalculatorRequest
  - `departure_airport` string, required — Departure airport ICAO code / IATA code / Local identifier or coordinates. e.g. "LSGG", "RIX", "39.7841944444 -104.537638889"
  - `arrival_airport` string, required — Arrival airport ICAO code / IATA code / Local identifier or coordinates. e.g. "KJFK", "BCA", "8.45991666667 48.5683611111
  - `aircraft` string, required — Aircraft profile name / ICAO code / type. Profile name is preferable. e.g. "HondaJet (IASA regulations)", "CL60", "Global 6000"
  - `aircraft_tail_number` string — Aircraft tail number. Helps find exact aircraft profile. Overrides 'aircraft' parameter if found in Aviapages database.
  - `departure_datetime` string, date-time — Local time of departure in format "YYYY-MM-DDThh:mm". Default: current UTC datetime. e.g. "2020-10-28T12:00"
  - `pax` integer — Number of passengers.
  - `aircraft_custom_payload` integer — Custom payload parameter, kg. Overrides pax parameter.
  - `arrival_datetime` boolean — 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)
  - `great_circle_route` boolean — Calculate great circle route (shortest distance) as an array of coordinates between airports
  - `great_circle_carbon_emissions` boolean — Calculate carbon dioxide emissions via great circle using aircraft performance model, kg
  - `airway_carbon_emissions` boolean — Calculate carbon dioxide emissions via airways using aircraft performance model, kg
  - `airway_carbon_emissions_weather_impacted` boolean — Calculate carbon dioxide emissions via airways using aircraft performance model with historical average wind, kg
  - `great_circle_distance` boolean — Calculate distance between airports via great circle (shortest distance).
  - `great_circle_time` boolean — Calculate flight time via great circle (shortest distance) using aircraft performance model.
  - `great_circle_fuel` boolean — Calculate trip and block fuel via great circle using aircraft performance model.
  - `average_speed_time` boolean — Calculate flight time via great circle using aircraft's average speed constant. Simplest and fastest calculations.
  - `airway_route` boolean — Calculate airway route of coordinates between airports via airways.
  - `airway_time` boolean — Calculate flight time via airways using aircraft performance model.
  - `airway_distance` boolean — Calculate distance between airports via airways.
  - `airway_time_weather_impacted` boolean — Calculate flight time via airways using aircraft performance model with historical average wind impact. This is the recommended method for most accurate result.
  - `airway_fuel_weather_impacted` boolean — Calculate trip and block fuel via great circle using aircraft performance model with historical average wind.
  - `airway_fuel` boolean — Calculate trip and block fuel via airways using aircraft performance model.
  - `advise_techstops` boolean — Advise optimal airports for tech stop in case direct flight is not possible.
  - `ifr_route` boolean — Calculate route as a sequence of airways and airway points used for en-route navigation.
  - `airway_fuel_weather_impacted_detailed` boolean — Calculate and display detailed breakdown of fuel consumption via airways using aircraft performance model with historical average wind.
  - `airway_fuel_detailed` boolean — Calculate and display detailed breakdown of fuel consumption via airways using aircraft performance model.
  - `great_circle_fuel_detailed` boolean — Calculate and display detailed breakdown of fuel consumption via great circle using aircraft performance model.
  - `airway_average_wind_historical` boolean — Use historical average wind for airway calculations. This is the recommended method for most accurate result.
  - `avoid_countries` string[] — List of countries to avoid in airway calculations. e.g. ["Iran", "Syria"], ["UKR", "BLR"] or ["BY", "UA"]
  - `avoid_firs` string[] — List of FIR to avoid in airway calculations. e.g. ["UKDV", "UKBV"]
  - `etops` string — Use ETOPS in airway calculations. Possible values: "ETOPS90", "ETOPS120", "ETOPS180".
  - `tag` string — Set custom user tag. Helpful for debugging or logging.
  - `aircraft_degradation` number, double — Aircraft's aerodynamic and flight characteristics degradation factor, percent.
  - `aircraft_oew` integer — Custom aircraft's operating empty weight, kg.
  - `aircraft_mtow` integer — Custom aircraft's maximum takeoff weight, kg.
  - `aircraft_zfw` integer — Custom aircraft's zero fuel weight, kg.
  - `aircraft_max_fuel` integer — Custom aircraft's max fuel weight, kg.
  - `aircraft_taxi_fuel` integer — Custom aircraft's taxi fuel weight, kg.
  - `aircraft_alternate_fuel` integer — Custom aircraft's alternate fuel weight, kg.
  - `aircraft_holding_fuel` integer — Custom aircraft's holding fuel weight, kg.
  - `aircraft_contingency_fuel` integer — Custom aircraft's contingency fuel weight, kg.
  - `aircraft_extra_fuel` integer — Custom aircraft's extra fuel weight, kg.
  - `aircraft_optimal_flight_level` integer — Custom aircraft's optimal flight level, m.
  - `aircraft_cruise_speed` string — Custom aircraft's cruise speed. e.g. "M0.80", "M0.85", "M0.90", "M0.95", "M0.99"
  - `aircraft_mlw` integer — Custom aircraft's maximum landing weight, kg.
  - `aircraft_mzfw` integer — Custom aircraft's maximum zero fuel weight, kg.
  - `crossed_firs` boolean — Show FIRs crossed during the route
  - `crossed_countries` boolean — Show countries crossed during the route
  - `aircraft_taxi_time` integer — Total runway taxi time, minutes.
  - `fallback_eco_regime` boolean — 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.
  - `force_eco_regime` boolean — The calculation will be performed using the most efficient performance mode. Custom speed and altitude parameters will be ignored.
  - `flight_time_offset` integer — Flight time adjustment in minutes applied to the calculated flight duration; may be positive or negative.

## Response `200`

- FlightCalculatorResponse
  - `aircraft` string, required — Aircraft profile name.
  - `airport` FlightCalculatorResponseAirport, required
    - `departure` string, required — Departure airport ICAO code.
    - `arrival` string, required — Arrival airport ICAO code.
    - `techstops` string[], required — List of ICAO codes of recommended airports for techstop. Is displayed when "advise_techstop" is set to true and non-stop flight is not possible.
  - `distance` FlightCalculatorResponseDistance
    - `great_circle` number, double, required — distance via great_circle (shortest distance) in kilometers.
    - `airway` number, double, required — distance via airways in kilometers.
  - `route` FlightCalculatorResponseRoute
    - `ifr_route` string[], required — Sequence of airway points codes and airway names. Starts and end with departure and arrival airport ICAO codes respectively.
    - `great_circle` Coordinates[], required — Array of coordinates of great circle route.
      - `lo` number, double, required
      - `la` number, double, required
    - `airway` Coordinates[], required — Array of coordinates of airway route.
      - `lo` number, double, required
      - `la` number, double, required
    - `crossed_firs` string[], required — List of FIRs crossed during the route. Showed when "crossed_firs" is set to true.
    - `crossed_countries` string[], required — List of countries crossed during the route. Showed when "crossed_countries" is set to true.
  - `time` FlightCalculatorResponseTime
    - `departure_local` string, date-time, required — Local time at departure airport in format "YYYY-MM-DDThh:mm".
    - `airway` integer, required — Flight time via airways using aircraft performance model in minutes.
    - `arrival_local_airway` string, date-time, required — Local time at arrival airport for calculation via airways using aircraft performance model in format "YYYY-MM-DDThh:mm".
    - `airway_weather_impacted` integer, required — Flight time via airways using aircraft performance model with wind impact in minutes.
    - `arrival_local_airway_weather_impacted` string, date-time, required — Local time at arrival airport for calculation via airways using aircraft performance model with wind impact in format "YYYY-MM-DDThh:mm".
    - `great_circle` integer, required — Flight time via great circle using aircraft performance model in minutes.
    - `arrival_local_great_circle` string, date-time, required — Local time at arrival airport for calculation via great circle using aircraft performance model in format "YYYY-MM-DDThh:mm".
    - `average_speed` integer, required — Flight time via great circle using aircraft's average speed constant (simplified) in minutes.
    - `arrival_local_average_speed` string, date-time, required — Local time at arrival airport for calculation via great circle using aircraft's average speed constant in format "YYYY-MM-DDThh:mm".
  - `fuel` FlightCalculatorResponseFuel
    - `airway` integer, required — Total amount of used fuel consumption via airways using aircraft performance model in kilograms.
    - `airway_weather_impacted` integer, required — Total amount of used fuel via airways using aircraft performance model with wind impact in kilograms.
    - `great_circle` integer, required — Total amount of used fuel via great circle using aircraft performance model with wind impact in kilograms.
    - `great_circle_detailed` FlightCalculatorResponseFuelGreatCircleDetailed[], required — Breakdown of fuel consumption via great circle using aircraft performance model.
      - `weight` number, double, required — Weight of aircraft by the end of current operation, kg
      - `distance` number, double, required — Distance flown, km
      - `duration` number, double, required — Operation duration, min
      - `fuel_used` number, double, required — Fuel burned, kg
      - `final_altitude` integer, required — Altitude by the end of current operation, m
      - `operation` string, required — Type of the operation
    - `airway_detailed` FlightCalculatorResponseFuelAirwayDetailed[], required — Breakdown of fuel consumption via airways using aircraft performance model.
      - `weight` number, double, required — Weight of aircraft by the end of current operation, kg
      - `distance` number, double, required — Distance flown, km
      - `duration` number, double, required — Operation duration, min
      - `fuel_used` number, double, required — Fuel burned, kg
      - `final_altitude` integer, required — Altitude by the end of current operation, m
      - `operation` string, required — Type of the operation
    - `airway_weather_impacted_detailed` FlightCalculatorResponseFuelairwayWeatherImpactedDetailed[], required — Breakdown of fuel consumption via airways using aircraft performance model with historical average wind.
      - `weight` number, double, required — Weight of aircraft by the end of current operation, kg
      - `distance` number, double, required — Distance flown, km
      - `duration` number, double, required — Operation duration, min
      - `fuel_used` number, double, required — Fuel burned, kg
      - `final_altitude` integer, required — Altitude by the end of current operation, m
      - `operation` string, required — Type of the operation
    - `airway_block` integer, required — Total fuel required for the flight via airways including all reserved and extra fuel
    - `airway_weather_impacted_block` integer, required — Total fuel required for the flight via airways with historical average wind including all reserved and extra fuel
    - `great_circle_block` integer, required — Total fuel required for the flight via great_circle including all reserved and extra fuel
  - `great_circle_carbon_emissions` integer, required — Carbon dioxide emissions via great circle using aircraft performance model in kilograms.
  - `airway_carbon_emissions` integer, required — Carbon dioxide emissions via airways using aircraft performance model in kilograms.
  - `airway_carbon_emissions_weather_impacted` integer, required — Carbon dioxide emissions via airways using aircraft performance model with historical average wind in kilograms.
  - `errors` FlightCalculatorResponseErrors[] — Sequence of error codes and messages caught during calculation.
    - `message` string, required — Error code.
    - `code` integer, required — Error description.
  - `warnings` FlightCalculatorResponseWarnings[] — Sequence of warning codes and messages caught during calculation.
    - `message` string, required — Warning code.
    - `code` integer, required — Warning description.

## Other responses

- `400`
- `429`

---

[API](https://skmtc.dev/aviapages/apis/aviapages-api-documentation.md) · [All operations](https://skmtc.dev/aviapages/apis/aviapages-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aviapages/aviapages-api-documentation/revisions/c9d946178412/schema)