What's new
API updates, new endpoints, and improvements across the OAG platform.
Latest update
ServiceType filter now supports individual IATA service type codes
More granular filtering is now available in Flight Info API. In addition to the existing 'Passenger' and 'Cargo' group names, you can now filter by individual IATA service type codes (e.g. J, G, U). No changes to the response schema — this is a data filtering improvement only.
Flight Info APIDiverted flights are now included by default in search results. A new isDiverted field is returned on the flight object to indicate diversion status.
A new map field has been added and is returned when the flight status is inAir. It provides a link to a tracker map allowing you to view the plane's position in real time.
The Flight Info API now includes recovery flights when filtering by 'Passenger'. This ensures all relevant passenger-related flights, including recovery operations, are returned.
The v1 version of the Flight Info API has been permanently removed following the announced sunset period. All requests to v1 endpoints now receive a 404 Not Found response.
With the addition of the Codeshare filter, Flight Info API is now able to filter results by operating or marketing flights. Codeshare can be filtered by specifying either Operating or Marketing. By default, if neither strings are provided, all flights will be returned.
The Flight Info API now returns Distances in kilometers, miles and nautical miles.
Diverted Flights are now included under the original flight with additional status message fields: irregular operation type (Diverted), diversion type (Undefined, Unplanned, InAirReturn, TechnicalStop), and updated arrival airport/country to the diversion airport. Recovery Flights are created as unscheduled flights with an irregular operation type of Recovery and a link back to the original scheduled flight.
The Flight Info API now returns a hyperlink from a recovery flight to the original scheduled flight. It is provided as property originalFlight.
The Flight Info API now has a new Single Direct Flight endpoint enabling you to retrieve a specific flight schedule by instance key and departure date.
The Flight Info API now returns Cargo Tonnage.
With the addition of two new filters, Flight Info API is now able to be searched via arrival and departure country code. Country code can be searched and viewed as a two-letter ISO code of the country where an airport is located.
This feature allows searching by multiple carriers in Flight Info API. To use it, enter comma-separated carrier codes in the CarrierCode parameter.
Diverted flights no longer have a dedicated Diverted flight state. The presence of a Diversion Airport (IATA, ICAO, FAA) node now indicates a diverted flight, allowing status updates such as InAir or Landed to continue. Subsequent local status times are presented in the local time zone of the diversion airport.
Departure and Arrival date/time (UTC) and Elapsed time added to the Flight Info API response. SchedulesInstanceKey and StatusKey are now exposed. API version v2 released with parameter/property renames, property removals, and changes to mandatory/default values. An API version life cycle policy was also introduced.
The Arrival and Departure date search parameters in Flight Info API now optionally accept hours and minutes.
Filter passenger and/or cargo flights using the new ServiceType parameter. If not specified, all flights are returned.
General Aviation (GA) and Unscheduled flights for the North America region are now available. Use the FlightType parameter with values GA, Unscheduled, or Scheduled to filter results.
IataCarrierCode and IcaoCarrierCode parameters are deprecated and will be removed. Replace them with CarrierCode and CodeType. If CodeType is not specified, carriers and airports are searched by IATA (default).
You can now search by Aircraft registration (Tail) number in the Flight Info API.
Date range search is now available in the Flight Info API. Enter two dates separated with a slash, e.g., DepartureDate=2022-01-04/2022-01-11.
Multiple airports can now be searched in the Flight Info API. Enter comma-separated IATA airport codes in the DepartureAirport or ArrivalAirport parameters, e.g., DepartureAirport=LHR,LCY,LGW.
New schedule data fields added: on-time performance (percentage on-time, late, cancelled), in-flight services, automated check-in, electronic ticketing, secure flight information, and government approval.
Seating capacity data now available by 5 cabins (first, business, premium economy, economy plus, economy) and total seat count. Data is enhanced with the OAG Data Science model.
The OAG Developer Portal launched with the Flight Info API and Flight Changes API. Flight Info API provides near real-time access to the full spectrum of OAG schedules data. Flight Changes API allows retrieval of schedules introduced, changed, or deleted from a specific date.
The Schedules API now returns equipment type in the segment information for flights with multiple stops.
The Schedules API now returns Distances in kilometers, miles and nautical miles, plus Passenger Arrival and Departure UTC times and overall Elapsed Time.
The Schedules API now returns Cargo Tonnage and both IATA and ICAO aircraft types.
The Schedules API now supports searching by departure date range. Provide two dates separated by a slash in the format DepartureDate=YYYY-MM-DD/YYYY-MM-DD to return schedules for flights operating within that range.
Following customer feedback, the maximum circuity threshold has been increased from 200% to 250%, allowing a broader range of viable connections to be displayed.
Multi-value search is now available — provide a comma-separated list of carrier codes for the 1st and 2nd leg carrier code parameters. Additionally, only one of the Origin or Destination parameters is now required to execute a connection search.
Cargo service type flights and ground services are now included in global single connections. A new service filter lets you search for passenger and/or cargo connections.
The Flight Info Connections API is now available. It provides weekly-updated global single passenger connections built on OAG schedules and industry-compliant Minimum Connecting Times (MCTs). Supports Online, Interline, and Offline connection types with global coverage.
A new 'changes' field has been added at the root of the schedule event in Event Hubs. Filtering by change indicators is still supported only via status alerts.
New fields added at the root of the event: DiversionType, IrregularOperationType, OriginalStatusKey. Also added Scheduled.Country.Code and Country.Code under Arrival and Departure nodes.
New filters let you set thresholds for matching Estimated Arrival Time (ETA) and Estimated Departure Time (ETD) based on estimated outGateVariation and inGateVariation fields. Thresholds accept a value between -1440 and +1440 minutes. By default thresholds are not applied.
A new codeshare filter controls whether marketing flights are included in schedule and status flight updates. The filter defaults to true, meaning marketing flights are included. Set it to false to suppress marketing flight updates.
Alerts can now be filtered by specific flight status changes — gates, aircraft registration, baggage, terminal, seats, and aircraft type. Filters default to enabled (true) for all active and new alerts. A flight update satisfies the filter if any condition set to true is met.
A changes section is now included in each flight update body, showing the name of the data item that changed and its previous value. Change Indicators default to false; set the new changeIndicator parameter to true when creating or updating an alert to enable them.
Alerts can now track General Aviation (GA) and Unscheduled flights for the North America region. FAA airport codes are included in flight updates when available. Use the new GA and Unscheduled parameters when creating or updating an alert to opt in.
Flight Info Alerts has moved from showing schedules in effective periods to showing them at the individual flight instance level. This provides a more granular view and increases event volume as changes are now recorded per flight rather than per effective period.
The Flight Info Alerts product is now available. It provides near real-time change events across the full spectrum of OAG schedules data without requiring an API lookup. Users configure which schedule changes they want to receive by date, route, airline, and flight number range.
The Carriers API now provides more complete data for each carrier, including name, domicile.country.code.dot, and domicile.country.code.iso, consistently populated across the dataset.
The Equipment API now returns a list of valid service types for which the equipment is approved or suitable for use on flight schedules.
The Master Data API suite is now available, providing access to essential aviation codes and descriptive data. Includes: Locations API (IATA, ICAO, FAA airport codes with names, types, geo positions, countries, cities, time zones, DST), Carriers API (IATA and ICAO carrier codes with names, domicile, and code rank), and Equipment API (IATA, ICAO, FAA equipment codes with aircraft categories, engine types, body type, and manufacturer).