Flight Status and Schedules API
Flight status, airport departure and arrival schedules, route resolution and FAA airport delays, with status-change webhooks. Delivered as JSON over a versioned REST API; flight data comes from aggregated third-party sources and delay data from the FAA.
curl "https://data.skylinkapi.com/v3.1/flight_status/BA123" \
-H "x-api-key: YOUR_API_KEY"One flight’s status, departure and arrival
Times are local to each airport. Gate, terminal, check-in and baggage are empty strings, not null, until they are published.
- flight_number, airlinestring
- Display flight number and airline name.
- statusstring
- Current status label. Display text, not a fixed enumeration.
- departure.airport, airport_fullstring
- Departure airport code and name.
- departure.scheduled_time, scheduled_datestring
- Local scheduled departure.
- departure.actual_time, actual_datestring
- Actual or latest known departure.
- arrival.estimated_time, estimated_datestring
- Latest estimated arrival while en route.
- terminal, gatestring
- On both legs. An empty string until the airline or airport publishes them.
- departure.checkin, arrival.baggagestring
- Check-in desk and baggage belt, empty until published.
| Field | Type | Meaning |
|---|---|---|
| flight_number, airline | string | Display flight number and airline name. |
| status | string | Current status label. Display text, not a fixed enumeration. |
| departure.airport, airport_full | string | Departure airport code and name. |
| departure.scheduled_time, scheduled_date | string | Local scheduled departure. |
| departure.actual_time, actual_date | string | Actual or latest known departure. |
| arrival.estimated_time, estimated_date | string | Latest estimated arrival while en route. |
| terminal, gate | string | On both legs. An empty string until the airline or airport publishes them. |
| departure.checkin, arrival.baggage | string | Check-in desk and baggage belt, empty until published. |
{
"flight_number": "BA 123",
"airline": "British Airways",
"status": "En Route",
"departure": {
"airport": "EGLL",
"airport_full": "London Heathrow Airport",
"scheduled_time": "10:30",
"scheduled_date": "11 Feb",
"actual_time": "10:35",
"actual_date": "11 Feb",
"terminal": "5",
"gate": "A12",
"checkin": ""
},
"arrival": {
"airport": "KJFK",
"airport_full": "John F Kennedy International Airport",
"scheduled_time": "14:45",
"scheduled_date": "11 Feb",
"estimated_time": "14:50",
"estimated_date": "11 Feb",
"terminal": "7",
"gate": "B15",
"baggage": ""
}
}- Time, Date
- Local scheduled time and date.
- Flight, Airline
- Flight number and operating airline.
- IATA, Destination
- The other airport: code and city (Origin on arrivals).
- Status
- Status text, for example an estimated time or Landed.
| Schedule row | Meaning |
|---|---|
| Time, Date | Local scheduled time and date. |
| Flight, Airline | Flight number and operating airline. |
| IATA, Destination | The other airport: code and city (Origin on arrivals). |
| Status | Status text, for example an estimated time or Landed. |
Status, schedules, routes, delays and events
NOTAMs have their own product page. All requests go to https://data.skylinkapi.com/v3.1 with the x-api-key header.
- GET/flight_status/{flight_number}Status, times, terminal and gate for one flight by IATA or ICAO flight number.
- GET/schedules/departuresDepartures from an airport over a time window, from 5 days back to 1 day ahead.
- GET/schedules/arrivalsArrivals at an airport, in the same row shape as departures.
- GET/routes/callsign/{callsign}Departure and arrival airports for a callsign, with a confidence level.
- GET/routes/airport/{code}Routes from or to an airport, with frequency statistics.
- GET/delays/faaActive FAA ground stops, ground delay programmes, closures and airspace flow programmes.
- GET/delays/faa/{icao}FAA delay programmes affecting one US airport.
- POST/webhooksSubscribe an HTTPS endpoint to status changes for a flight.
- GET/distanceGreat-circle distance, initial bearing and midpoint between two airports or coordinates.
- GET/briefing/flightAn AI-generated preflight briefing for an origin and destination, as JSON or Markdown; /briefing/pdf returns a PDF.
Scope, source and limits
- Source
- Flight status, schedules and routes come from aggregated third-party sources. FAA delay programmes come from the FAA. Distance is computed by SkyLink from airport coordinates.
- Coverage
- Status and schedules for flights and airports the sources publish. Schedules cover a window from 5 days back to 1 day ahead. FAA delays cover US airports and territories only.
- Webhooks
- Flight-status events to HTTPS endpoints. Status is checked every 5 minutes; failed deliveries are retried up to 4 times, and a subscription is disabled after 10 consecutive failures. Events are not signed. Pro includes 1 webhook; Basic includes none.
- Limits
- The status endpoint has no date parameter: it returns the current operation. Status labels are display text. Operator resolution by ICAO prefix is less reliable than IATA flight numbers. Briefings are AI-generated.
- Use
- Informational. Not certified for dispatch release, navigation or other safety-critical use.
Where teams use it in production
Travel platforms and booking flows
Status, times and gates on itinerary pages, with webhook events to notify travellers when a flight changes.
Airport and ground-handling operations
Departure and arrival boards by airport over a time window, for staffing, stand and gate planning.
Dispatch and operations control
FAA ground stops and ground delay programmes for US airports beside the day’s schedule, refreshed every few minutes.
Schedule analytics and logistics
Schedules, routes from an airport and callsign-to-route resolution as inputs to ETL, ETA and network analysis.
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
Products, guides and articles
Guides
All SkyLink data is informational and not certified for navigation or other safety-critical use.
Get started
Flight status and schedules under contract
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.
