{"openapi":"3.1.0","info":{"title":"Glide Ratio API","version":"1.0.0","description":"Aircraft glide-performance maths as an API, computed locally and deterministically — the glide-distance, glide-ratio and reachability numbers a pilot, flight-instructor or flight-sim developer works an engine-out or soaring problem with. The glide-distance endpoint gives the still-air distance you can cover = height above the ground × the glide ratio (L/D): from 5,000 ft at a 9:1 ratio you reach about 45,000 ft, ~7.4 nm, with the answer in feet, nautical miles and kilometres. The glide-ratio endpoint reads the slope straight off the polar — glide ratio = forward speed ÷ sink rate (1 knot ≈ 101.27 ft/min), so 60 kt at a 600 ft/min sink is about 10:1, a 5.6° glide path — and gliders reach 40–60:1, a light single ~9:1, an airliner ~17:1. The reach endpoint answers the practical question: the height needed to reach a field = distance ÷ glide ratio, the arrival height is what is left, and it only counts as making it if that clears a safety reserve (default 1,000 ft) for the circuit and approach. Everything is computed locally and deterministically, so it is instant and private. Ideal for flight-planning and EFB apps, gliding and soaring tools, flight-simulator and training utilities, and aviation-safety calculators. Pure local computation — no key, no third-party service, instant. Still-air estimates — adjust for wind, configuration and a margin. 3 compute endpoints. For density altitude use a density-altitude API; for runway wind components a crosswind API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/glideratio-api","description":"oanor gateway"}],"tags":[{"name":"Glide"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/glide-distance":{"get":{"operationId":"get_v1_glide_distance","tags":["Glide"],"summary":"Glide distance from height and ratio","description":"","parameters":[{"name":"height_ft","in":"query","required":true,"description":"Height above landing point (ft)","schema":{"type":"string"},"example":"5000"},{"name":"glide_ratio","in":"query","required":true,"description":"Glide ratio (L/D)","schema":{"type":"string"},"example":"9"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Still-air glide distance = height above the ground × the glide ratio (L/D): from 5,000 ft at a 9:1 ratio you can reach about 45,000 ft, ~7.4 nm. A headwind shortens it and a tailwind extends it, since the airframe still sinks at the same rate while the ground moves underneath — so plan an engine-out glide with a margin, and remember the figure is for the best-glide speed; faster or slower both steepen the descent.","inputs":{"height_ft":5000,"glide_ratio":9},"glide_distance_ft":45000,"glide_distance_km":13.72,"glide_distance_nm":7.41},"meta":{"timestamp":"2026-06-07T08:18:05.642Z","request_id":"cd6e46cf-b57c-45d3-89dc-4d62c9591d86"},"status":"ok","message":"Glide distance","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/glide-ratio":{"get":{"operationId":"get_v1_glide_ratio","tags":["Glide"],"summary":"Glide ratio from airspeed and sink","description":"","parameters":[{"name":"airspeed_kt","in":"query","required":true,"description":"Airspeed (knots)","schema":{"type":"string"},"example":"60"},{"name":"sink_rate_fpm","in":"query","required":true,"description":"Sink rate (ft/min)","schema":{"type":"string"},"example":"600"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Glide ratio = forward speed ÷ sink rate (in the same units): 60 kt (≈ 6,076 ft/min) at a 600 ft/min sink is about 10:1, a 5.7° glide path. It is the slope of the glide, read straight off the aircraft's polar — gliders reach 40–60:1, a light single ~9:1, an airliner ~17:1. The best ratio comes at one particular speed; fly faster or slower and the sink rate rises, steepening the glide.","inputs":{"airspeed_kt":60,"sink_rate_fpm":600},"glide_ratio":10.13,"glide_angle_deg":5.64,"glide_ratio_label":"10.1:1"},"meta":{"timestamp":"2026-06-07T08:18:05.735Z","request_id":"d68692a3-cf26-4676-a06d-2a0ef28a8aef"},"status":"ok","message":"Glide ratio","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/reach":{"get":{"operationId":"get_v1_reach","tags":["Glide"],"summary":"Airfield reachability","description":"","parameters":[{"name":"height_ft","in":"query","required":true,"description":"Current height (ft)","schema":{"type":"string"},"example":"5000"},{"name":"glide_ratio","in":"query","required":true,"description":"Glide ratio (L/D)","schema":{"type":"string"},"example":"9"},{"name":"distance_nm","in":"query","required":true,"description":"Distance to field (nm)","schema":{"type":"string"},"example":"5"},{"name":"safety_height_ft","in":"query","required":false,"description":"Safety reserve (ft, default 1000)","schema":{"type":"string"},"example":"1000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Height needed to reach a field = distance ÷ glide ratio; the arrival height is what is left over. It only 'makes it' here if that arrival height clears a safety reserve (default 1,000 ft) for the circuit and approach — gliding to exactly zero leaves nothing for manoeuvring. Subtract wind, and never bet on the book ratio: a rough field or a draggy configuration eats into it fast.","inputs":{"height_ft":5000,"distance_nm":5,"glide_ratio":9,"safety_height_ft":1000},"makes_it":true,"height_needed_ft":3376,"arrival_height_ft":1624},"meta":{"timestamp":"2026-06-07T08:18:05.827Z","request_id":"70eb0860-7def-4e83-8bfd-f93cd064c438"},"status":"ok","message":"Reachability","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"notes":"ft, nm, km, kt, fpm. distance = height × ratio; ratio = airspeed ÷ sink (1 kt = 101.27 ft/min); height needed = distance ÷ ratio. Still-air estimates — adjust for wind and configuration. For density altitude use a density-altitude API; for wind components a crosswind API.","service":"glideratio-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/reach":"Whether a field is within glide range, and the arrival height.","GET /v1/glide-ratio":"Glide ratio (L/D) and glide angle from airspeed and sink rate.","GET /v1/glide-distance":"Still-air glide distance from height and glide ratio."},"description":"Glide-performance maths: glide distance from height and ratio, glide ratio from airspeed and sink, and airfield reachability."},"meta":{"timestamp":"2026-06-07T08:18:05.920Z","request_id":"9b43b575-a3cb-44fb-8a1a-f92ee1e78d6a"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":6100,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1050,"monthly_call_quota":63000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3340,"monthly_call_quota":265000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":10100,"monthly_call_quota":1350000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/glideratio-api"}