Nav Log
Calculate a complete navigation log for a flight including wind correction angles, ground speeds, and fuel burn.
POST
/api/v1/navlog/calculateCommercial PilotCalculate Navlog
Request BodyNavlogRequestDto
waypointsWaypointDto[]Ordered list of waypoints defining the route.
idstringWaypoint identifier (e.g., ICAO code or custom name).
namestringDisplay name of the waypoint.
latitudenumberLatitude in decimal degrees.
longitudenumberLongitude in decimal degrees.
altitudenumberAltitude in feet MSL.
waypointTypeWaypointTypeAirport | Custom | CalculatedPoint | Navaid
refuelGallonsnumbernullableGallons to add during a refueling stop.
refuelToFullbooleannullableWhether to refuel to full capacity at this stop.
isRefuelingStopbooleannullableWhether this waypoint is a refueling stop.
performanceDataNavlogPerformanceDataDtoAircraft performance data used for navigation log calculations.
climbTrueAirspeedintegerTrue airspeed during climb in knots.
cruiseTrueAirspeedintegerTrue airspeed during cruise in knots.
descentTrueAirspeedintegerTrue airspeed during descent in knots.
climbFpmintegerRate of climb in feet per minute.
descentFpmintegerRate of descent in feet per minute.
climbFuelBurnnumberFuel burn rate during climb in gallons per hour.
cruiseFuelBurnnumberFuel burn rate during cruise in gallons per hour.
descentFuelBurnnumberFuel burn rate during descent in gallons per hour.
sttFuelGalsnumberFuel used during start, taxi, and takeoff in gallons.
fuelOnBoardGalsnumberTotal fuel on board at departure in gallons.
plannedCruisingAltitudeintegerPlanned cruising altitude in feet MSL.
timeOfDeparturedate-timePlanned departure time in UTC.
Responses
200Returns the calculated navigation logNavlogResponseDto
totalRouteDistancenumberTotal route distance in nautical miles.
totalRouteTimeHoursnumberTotal route time in hours.
totalFuelUsednumberTotal fuel used for the route in gallons.
averageWindComponentnumberAverage wind component across all legs (negative = headwind).
legsNavigationLegDto[]Individual navigation legs with computed data.
legStartPointWaypointDtoA waypoint along a navigation route.
legEndPointWaypointDtoA waypoint along a navigation route.
trueCoursenumberTrue course in degrees.
magneticHeadingnumberMagnetic heading in degrees (corrected for wind and variation).
magneticCoursenumberMagnetic course in degrees (corrected for variation only).
groundSpeednumberGround speed in knots.
legDistancenumberLeg distance in nautical miles.
distanceRemainingnumberRemaining distance to destination in nautical miles.
startLegTimedate-timeEstimated time at the start of this leg (UTC).
endLegTimedate-timeEstimated time at the end of this leg (UTC).
legFuelBurnGalsnumberFuel burned during this leg in gallons.
remainingFuelGalsnumberRemaining fuel at the end of this leg in gallons.
windDirintegerForecast wind direction in degrees true.
windSpeedintegerForecast wind speed in knots.
headwindComponentnumberHeadwind component in knots (negative = tailwind).
tempCnumberForecast temperature in degrees Celsius.
airspaceGlobalIdsstring[]Global IDs of controlled airspaces along the route.
specialUseAirspaceGlobalIdsstring[]Global IDs of special use airspaces along the route.
obstacleOasNumbersstring[]OAS numbers of obstacles along the route.
400If the request data is invalidApiErrorResponse
codestringMachine-readable error code (e.g., "AIRCRAFT_NOT_FOUND").
messagestringHuman-readable error message suitable for display.
detailsstringnullableAdditional error details (only included in development environment).
validationErrorsRecord<string, string[]>nullableField-level validation errors (only for validation failures).
timestampstringUTC timestamp when the error occurred.
traceIdstringnullableCorrelation ID for tracing the request.
pathstringnullableRequest path that generated the error.
404If the aircraft performance profile is not foundApiErrorResponse
codestringMachine-readable error code (e.g., "AIRCRAFT_NOT_FOUND").
messagestringHuman-readable error message suitable for display.
detailsstringnullableAdditional error details (only included in development environment).
validationErrorsRecord<string, string[]>nullableField-level validation errors (only for validation failures).
timestampstringUTC timestamp when the error occurred.
traceIdstringnullableCorrelation ID for tracing the request.
pathstringnullableRequest path that generated the error.
503ApiErrorResponse
codestringMachine-readable error code (e.g., "AIRCRAFT_NOT_FOUND").
messagestringHuman-readable error message suitable for display.
detailsstringnullableAdditional error details (only included in development environment).
validationErrorsRecord<string, string[]>nullableField-level validation errors (only for validation failures).
timestampstringUTC timestamp when the error occurred.
traceIdstringnullableCorrelation ID for tracing the request.
pathstringnullableRequest path that generated the error.
Code Examples
curl \
-X POST \
-H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"waypoints": [
{
"id": "KCLT",
"name": "Charlotte Douglas Intl",
"latitude": 35.214,
"longitude": -80.9431,
"altitude": 748,
"waypointType": "Airport",
"isRefuelingStop": false
},
{
"id": "KTYS",
"name": "McGhee Tyson",
"latitude": 35.811,
"longitude": -83.994,
"altitude": 981,
"waypointType": "Airport",
"isRefuelingStop": true,
"refuelToFull": true
},
{
"id": "KBNA",
"name": "Nashville Intl",
"latitude": 36.1245,
"longitude": -86.6782,
"altitude": 599,
"waypointType": "Airport",
"isRefuelingStop": false
}
],
"performanceData": {
"climbTrueAirspeed": 80,
"cruiseTrueAirspeed": 120,
"descentTrueAirspeed": 100,
"climbFpm": 500,
"descentFpm": 500,
"climbFuelBurn": 10,
"cruiseFuelBurn": 8.5,
"descentFuelBurn": 5,
"sttFuelGals": 1.2,
"fuelOnBoardGals": 40
},
"plannedCruisingAltitude": 7500,
"timeOfDeparture": "2026-02-10T12:12:03Z"
}' \
"https://preflightapi-apim-service.azure-api.net/api/v1/navlog/calculate"