Flight Status & Track by Flight

Additional documentation for Flight Status and Flight Track is available on the new Cirium Developer Studio. The Developer Studio also includes in-depth articles on Cirium Flight Status and Codeshares & wet lease relationships.

We are currently integrating signup, login, and admin functionality on the Cirium Developer Studio. In the meantime, continue to use developer.flightstats.com to manage your application keys and accounts. Learn more

Skip to the Interactive Docs

The Flight Status APIs give you access to current flight information, including scheduled, estimated and actual departure/arrival times, equipment type, delay calculations, terminal, gate and baggage carousel. Current flight information is made available for flights for roughly three days in advance of departure until roughly seven days after arrival.

URI
https://api.flightstats.com/flex/flightstatus/{protocol}/v2/{format}/flight/status/{...}
Extended Options
includedeltas useHTTPErrors useInlinedReferences includeNewFields languageCode:xx
Response
request, appendix, error, list of flightStatus

The Flight Tracks APIs give you access to information on an active flight, including position (lat/long), altitude, bearing, speed and route. Initial flight plans and aircraft positions are made available when they are received (often roughly 24 hours in advance for flight plans) until roughly seven days after arrival.

Cirium provides the best available position for active flights, either ASDI from the FAA or ADS-B from transceivers located around the globe. In cases where the flight is out of range of either of these systems -- such as ocean crossings -- Cirium derives the position based on the last known location and its destination. With a sourceType of 'derived', the API automatically returns the best available position. Users also have the option of requesting the 'raw' data (either ASDI or ADS-B) or 'all' which will return both derived and raw in the same payload.

URI
https://api.flightstats.com/flex/flightstatus/{protocol}/v2/{format}/flight/track/{...}
Extended Options
useHTTPErrors useInlinedReferences includeNewFields languageCode:xx
Response
request, appendix, error, list of flightTrack

Flight Status schemas

Long Term Support (?)
SOAP (deprecated): WSDL | XSD
REST: WADL | XSD
Extended Fields (?)
SOAP (deprecated): WSDL+XSD
REST: WADL | XSD | JSON

Flight Tracks schemas

Long Term Support (?)
SOAP (deprecated): WSDL | XSD
REST: WADL | XSD
Extended Fields (?)
SOAP (deprecated): WSDL+XSD
REST: WADL | XSD | JSON

Interactive Documentation

  1. Click on the name of the web service to expand the test client interface.
  2. Fill out each required parameter (click app id & key to pre-populate with your credentials)
  3. Send Request to see the actual JSON response. You will also be provided with a curl invocation including a pre-formatted REST URL. To see the XML response, replace the json in the URL with xml.
  4. Please be aware that large responses may take a long time to pretty-print in your browser.

Common Questions

Flight Status Extended Options

These can be used in conjunction with other Extended Options to customize API behavior to fit specific needs.
Option Description
includeDeltas Causes the FlightStatus documents returned to include a full history of all changes recorded.