Download OpenAPI specification:Download
The Ratings APIs, part of the FlightStats APIs, provides ratings of a flight's performance relative to other flights. The score produced by the ratings process accounts for both on-time percentage and degree of lateness.
The API response includes percentage and “stars” ratings. The Stars number represents a rating on a scale of 1 to 5.
You can query the API both by flight (defined by carrier code and flight number for example, HA25) and by route (defined by departure airport and arrival airport for example, PDX to HNL).
Ratings APIs answer questions such as:
Flight Rating APIs are standard APIs and included in our Commercial and Contract plans.
A breakdown of the available plans is available on Get evaluation account
FlightStats On-time Performance Rating - Ratings by flight
Cirium Flight Search for Road Warriors - Example mashup of schedules, ratings by route, and flight features
Historical Flight Status - Status for flights back to 2006
Returns the calculated ratings information for a given airline and flight number. A rating element is returned for each departure/arrival airport pair that the flight flew during the observed time period.
format required | string Enum: "json" "jsonp" "xml" Example: json The data format returned in the response |
carrier required | string Example: AS The airline operating the flight |
flightNumber required | string Example: 2227 The flight number |
departureAirport | string Example: departureAirport=PDX An optional filter to limit results to a specific departure airport |
codeType | string Enum: "FS" "IATA" "ICAO" Example: codeType=FS Airport code type. If not specified, the code searches in the order: IATA, ICAO, FS. |
extendedOptions | Array of strings Items Enum: "useHttpErrors" "useInlinedReferences" "includeNewFields" "languageCode:en" "languageCode:ar" "languageCode:de" "languageCode:es" "languageCode:fr" "languageCode:ja" "languageCode:ko" "languageCode:pt" "languageCode:zh" Extended options for modifying standard API behavior to fit special use cases |
Flight Ratings response with one or more ratings
Returns the calculated ratings information for all flights having the given departure and arrival airports
format required | string Enum: "json" "jsonp" "xml" Example: json The data format returned in the response |
departureAirport required | string Example: PDX Departure airport code |
arrivalAirport required | string Example: SEA Arrival airport code |
codeType | string Enum: "FS" "IATA" "ICAO" Example: codeType=FS Airport code type. If not specified, the code searches in the order: IATA, ICAO, FS. |
extendedOptions | Array of strings Items Enum: "useHttpErrors" "useInlinedReferences" "includeNewFields" "languageCode:en" "languageCode:ar" "languageCode:de" "languageCode:es" "languageCode:fr" "languageCode:ja" "languageCode:ko" "languageCode:pt" "languageCode:zh" Extended options for modifying standard API behavior to fit special use cases |
Flight Ratings response with one or more ratings