Flight Time Estimate API
A gate-to-gate flight-time estimate for any origin and destination, produced by a trained machine-learning model and returned with a range. One GET request on the versioned REST API, optionally refined by aircraft type.
curl "https://data.skylinkapi.com/v3.1/ml/flight-time?from=KSFO&to=KJFK&aircraft=B738" \
-H "x-api-key: YOUR_API_KEY"An estimate in minutes, with bounds
Use estimated_minutes for calculations, estimated_hours_display for labels, and the min and max fields when you need a range.
- origin, destinationstring
- Resolved ICAO codes. ICAO or IATA codes are accepted on input.
- aircraft_typestring | null
- The ICAO type used, or null when none was passed.
- distance_nmnumber
- Great-circle distance in nautical miles.
- estimated_minutesinteger
- Gate-to-gate estimate, including average taxi at both ends.
- estimated_hours_displaystring
- The same estimate as a label, for example "4h 54m".
- min_minutes, max_minutesinteger
- Lower and upper bounds of the estimate range.
- model_versionstring
- The model artifact that produced the estimate. Record it when you audit results.
| Field | Type | Meaning |
|---|---|---|
| origin, destination | string | Resolved ICAO codes. ICAO or IATA codes are accepted on input. |
| aircraft_type | string | null | The ICAO type used, or null when none was passed. |
| distance_nm | number | Great-circle distance in nautical miles. |
| estimated_minutes | integer | Gate-to-gate estimate, including average taxi at both ends. |
| estimated_hours_display | string | The same estimate as a label, for example "4h 54m". |
| min_minutes, max_minutes | integer | Lower and upper bounds of the estimate range. |
| model_version | string | The model artifact that produced the estimate. Record it when you audit results. |
{
"origin": "KSFO",
"destination": "KJFK",
"aircraft_type": "B738",
"distance_nm": 2241.75,
"estimated_minutes": 294,
"estimated_hours_display": "4h 54m",
"min_minutes": 259,
"max_minutes": 329,
"model_version": "2.0.0-wind"
}Estimates and the inputs around them
All requests go to https://data.skylinkapi.com/v3.1 with the x-api-key header.
- GET/ml/flight-timeGate-to-gate estimate for an origin and destination, with an optional ICAO aircraft type.
- GET/distanceGreat-circle distance, initial bearing and midpoint between two airports or coordinates.
- GET/aircraft/performance/{icao_type}Published performance figures for an aircraft type, such as cruise speed and wake category.
- GET/carbon/estimatePer-flight COâ‚‚ estimate for the same city pair, following the ICAO methodology.
What the estimate is, and what it is not
An estimate carries no guarantee. The scope below is the documented one.
- Method
- A trained machine-learning model returns the estimate. It is a statistical average for the route and aircraft category, not a forecast for a specific departure.
- Inputs
- Origin and destination (ICAO or IATA), and an optional ICAO aircraft type. Without a type, typical jet cruise parameters are used. Average taxi time at both ends is included.
- Not modelled
- Wind and live en-route weather.
- Fallback
- If the model is temporarily unavailable, a distance and speed calculation may be returned instead. model_version tells you which produced the result.
- Use
- Informational. Not certified for navigation, flight planning or other safety-critical use.
Where teams use it in production
Booking and itinerary tools
Show an expected gate-to-gate duration where a schedule is missing, labelled as an estimate.
Connection planning
Use min_minutes and max_minutes as a range when sizing connection buffers.
Schedule and fleet analysis
Compare scheduled block times against an estimate by varying aircraft type on the same route.
Operations dashboards
Give dispatchers a reference duration per city pair without maintaining route tables.
What you can rely on
Each item links to the document behind it.
- 99.5% uptime SLAWith service credits, on Enterprise contracts
- Public status pageLive and historical availability
- MSA and DPAStandard contract documents, ready to review
- Security overviewWhat we store, where it runs, how to report
- Versioned API (v3.1)Documented response contracts
- EU-established supplierRegistered in Italy, VAT IT04163490123
Get started
Talk to the people who run the service
For volume, a contract, a security review or a data question, write to us and you will reach the engineers directly. Self-serve plans start at checkout.
