April 30, 2025
Change indicators are now included in schedule events in Event Hubs for Flight Info Alerts
New field at the root of the schedule event: changes.
Please note that filtering by change indicators is still supported only via status alerts.
April 14, 2025
Flight Info API v1 no longer available
The v1 version of the Flight Info API has been permanently removed following the announced sunset period. All requests to v1 endpoints will now receive a 404 Not Found response. Please use to the Flight Info - v2 for continued service.
March 27, 2025
Recovery and diverted flights fields are now included in status events in Event Hubs for Flight Info Alerts
New fields at the root of the event: DiversionType, IrregularOperationType, OriginalStatusKey;
New fields Scheduled.Country.Code and Country.Code under Arrival and Departure nodes;
New field Departure.Scheduled.Airport with IATA, ICAO and FAA codes.
November 5, 2024
Codeshare filtering now in Flight Info API
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.
July 3, 2024
Distance now in Flight Info API
The Flight Info API now returns Distances in kilometers, miles and nautical miles.
June 18, 2024
Diverted/Recovery Flights Handling in Flight Info API
We are pleased to announce the release of the Diverted/Recovery flights handling feature in the Flight Info API. Key changes include:
Diverted Flights:
Status messages for diverted flights are now included under the original flight.
Additional information in status messages includes:
Irregular operation type: Diverted
Diversion type: Possible values include Undefined, Unplanned, InAirReturn, TechnicalStop.
The flight arrival airport/country in status messages changes to the diversion airport/country. Please note that queries are still based on the scheduled arrival airport. Consequently, arrival gate, terminal, and baggage information might also change based on the new information received.
Recovery Flights:
When a recovery flight occurs, it is created as an unscheduled flight. Additional information includes:
Irregular operation type: Recovery
A link to the original scheduled flight is included.
June 12, 2024
Flight Info API now includes recovery flight link
The Flight Info API now returns a hyperlink from a recovery flight to the original scheduled flight. It is provided as property originalFlight.
June 3, 2024
IATA and ICAO Equipment Type now returned in Schedules API Segment info
The Schedules API now returns equipment type in the segment information for flights with multiple stops.
May 16, 2024
Distance, Elapsed Time and Passenger UTC times now in Schedules API
The Schedules API now returns Distances in kilometers, miles and nautical miles. Also added Passenger Arrival and Departure UTC times and overall Elapsed Time.
May 13, 2024
Flight Info API new endpoint for single flight lookup
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.
April 4, 2024
Cargo Tonnage and Aircraft Type now in Schedules API
The Schedules API now returns Cargo Tonnage and both IATA and ICAO aircraft types.
March 19, 2024
Country Code filtering comes to Flight Info API
With the addition of two new filters, Flight Info API is now able to be searched via arrival and departure country code as well as you you can find these values in schedule and status responses. Country code can be searched and viewed as a two letter ISO code of a country where an airport is located.
January 15, 2024
Launching Master Data API
We're thrilled to announce the launch of the Master Data API suite - an integral addition to our product lineup. This suite seamlessly provides access to essential codes and descriptive data for key entities in the aviation domain.
Master Data API suite Features:
Locations API: Explore IATA, ICAO, and FAA airport codes alongside detailed information on names, types, geographical positions, countries, cities, time zones, and DST.
Carriers API: Access IATA and ICAO carrier codes with additional details such as carrier names, domicile, IATA's code assignment category, and code rank.
Equipment API: Dive into IATA, ICAO, and FAA equipment codes, accompanied by supplementary information on aircraft categories, engine types and count, aircraft body, manufacturer, and more.
Together, these APIs form the Master Data API suite, providing a unified solution to elevate your aviation data experience.
November 27, 2023
Thresholds for Estimated Arrival and Departure Time in Flight Info Alerts
In this release, we are introducing new filters designed to enhance your experience by allowing you to set thresholds for matching Estimated Arrival Time (ETA) and Estimated Departure Time (ETD), based on the estimated outGateVariation and estimated inGateVariation fields.
By default these thresholds are not applied. A threshold value can be set to a negative or positive value of 1440 in minutes for before or after the ETA or ETD respectively.
November 24, 2023
Enhancements in Flight Info Connections API: Multi-Carrier Search and Required Parameter Updates
With this release, we are introducing multi-value search capability to our Flight Info Connections API, allowing the addition of a list of comma-separated carrier codes for 1st leg and 2nd leg carrier code parameters.
In addition, we have modified the origin and destination search parameters required for running a connection search. Now, it is sufficient to fill only one of the Origin and Destination parameters to execute a query: the arrival (city or airport), the departure (city or airport), or the via-point.
November 16, 2023
Searching by multiple carriers in Flight Info API
This feature allows to search by multiple carriers in Flight Info API. To use this feature, enter comma-separated carrier codes in CarrierCode parameter.
November 13, 2023
Codeshare Filters in Flight Info Alerts
In this release, we are introducing a new filter designed to enhance your experience by allowing you to exclude marketing flights in schedules and status flight updates.
Please note that, by default, the codeshare filter is enabled (set to true), resulting in schedules and status updates with marketing flights. If your preference is to exclude marketing flight updates, simply set the codeshare filter to false.
October 05, 2023
Status Change indicators and filters
We have implemented a new feature that allows users to filter alerts based on flight status changes using various criteria, such as gates, aircraft registration number, baggage, terminal, seats, and aircraft type. This enhancement provides users with the flexibility to enable or disable receiving events based on the data field changes occurring within a series of status updates.
It's important to note that, by default, these filters are configured to be enabled (set to "true") for all currently active alerts as well as for any new alerts that are created. If you wish to opt out of receiving notifications for the specified changes, you will need to manually set these filters to "false."
Since a single flight update may contain changes to multiple data fields at once, the filters in this release will be triggered when a flight update satisfies any of the conditions set to true within the "StatusChangeFilters" object. I.e. if a user sets "gates" to true and "baggage" to false, a flight update that contains changes to both gates and baggage at once will not be blocked.
July 26, 2023
Search by departure date range in Schedules API
With the latest update to the Schedules API, we are introducing a new feature that allows you to search for flight schedules based on departure date range. To utilize this functionality, simply provide two dates separated by a slash in the following format: DepartureDate=YYYY-MM-DD/YYYY-MM-DD. The API will then return schedules for flights that operate within the specified date range, providing accurate and up-to-date information for your travel planning needs.
Please note that currently, the API also includes flight schedules that become valid during the provided date range, even though no operating flights are available.
July 17, 2023
Flight Diversions in Flight Info Products
We've enhanced our Flight Info API and Alerts Products. Now, when a flight is diverted, you'll see the change in a more intuitive way. We've removed dedicated "Diverted" Flight State. The presence of a Diversion Airport (IATA, ICAO, FAA) node now indicates a diverted flight. This change allows for continued updates on the flight's status, like InAir or Landed. Please note that the subsequent local status times will be presented in the local time zone of the diversion airport. With this adjustment, we have now made it easier for you to identify if a flight was diverted to another location while at the same time being in the air, or even right after it has left the gate.
June 21, 2023
Status Change indicators in Flight Info Alerts
This latest release makes it possible to see changes between a series of status updates that match a given alert. Within the body of each flight update, a "changes" section was added to show the name of the data item that changed and its previous value.
Note that by default, Change Indicators are set to false for all active Alerts. To enable Change Indicators, the new parameter “changeIndicator” was added to the alert creation/update requests. Setting this parameter to true will display the change indicators in the flight updates.
May 16, 2023
Flight Info API UTC date/time and v2 release
With this release, Departure and Arrival date/time (UTC) and Elapsed time have been added to Flight Info API response. We will enable data integration across multiple Flight Info API products by exposing SchedulesInstanceKey and StatusKey through Flight Info API.
To support this and future improvements, API version v2 is released. There have been changes made in Parameters and properties:
Change names of parameters and properties.
Removal of properties.
Changes in mandatory and default values in parameters.
API version life cycle policy was introduced, and it is described here.
The API call for version 1.0:
GET https://api.oag.com/flight-instances/?DepartureDate=2023-05-05&DepartureAirport=JFK&version=1.0
needs to be updated to retrieve the same results in version 2. The updated API call should be:
GET https://api.oag.com/flight-instances/?DepartureDateTime=2023-05-05&DepartureAirport=JFK&FlightType=scheduled&CodeType=IATA&version=v2
All the changes can be found in API version 2 Changelog
Switching from Flight Info API v1 to v2: A Step-by-Step Guide
March 16, 2023
GA/Unscheduled Flights in Flight Info Alerts
This latest release makes it possible to create or update Alerts which also track for GA/Unscheduled flights for the North America region. Within the body of each flight update, FAA airport codes will also be included for all flights when those details are available.
General Aviation flights stand for non-commercial business aviation (i.e., instructional, pleasure flying, aerial work, etc.).
Unscheduled flights are charter, on-demand (i.e., air-taxi, commercial business aviation).
Do note that by default, GA/Unscheduled flights are set to false for all currently active and new Alerts. To enable GA or Unscheduled flights, two new parameters were added in Alert creation/update: GA, Unscheduled. Setting these parameters to true will allow you to start receiving updates for these flights.
March 13, 2023
Using hours, minutes in Arrival and Departure time filter in Flight Info API
This feature allows the optional use of hours and minutes in the Arrival and Departure date search parameters in Flight Info API.
March 10, 2023
Search by Service Type in Flight Info API
We have now introduced the possibility to filter passenger and/or cargo flights by using the ServiceType parameter. If not specified all flights are returned.
March 02, 2023
GA/Unscheduled Flights in Flight Info API
We have introduced a new data set that allows getting General Aviation (GA) and Unscheduled flights for the North America region. To use this feature, enter GA, Unscheduled or Scheduled into the FlightType parameter.
GA flights stand for non-commercial business aviation (i.e., instructional, pleasure flying, aerial work, etc.).
Unscheduled flights are charter, on-demand (i.e., air-taxi, commercial business aviation).
January 27, 2023
Carrier and Airport parameter usage in Flight Info API
IataCarrierCode and IcaoCarrierCode parameters will be deprecated in Flight Info API and it will be supported for limited time. We recommend replacing it with CarrierCode and CodeType parameters. Carriers and Airports will be filtered according to specified CodeType parameters (IATA, ICAO or FAA). If CodeType is not specified, carriers and airports are searched by IATA (default).
January 23, 2023
Aircraft registration number parameter in Flight Info API
Introduced possibility to search by Aircraft registration (Tail) number in the Flight Info API.
September 29, 2022
Filter by Service (Passenger or Cargo) in Flight Info Connections API
With this release, cargo service type flights and ground services were added to global single connections. In addition, a new search by service is now available to filter passenger and / or cargo connections.
May 10, 2022
Introduction to Flight Info Connections API
We are excited to announce that our Flight Connections API is now available!
Flight Info Connections API enables customers to get weekly updated global single passenger connections. OAG connections are built using the most accurate and up-to-date schedules information, comprehensive and industry compliant Minimum Connecting Times (MCTs).
Key highlights:
Coverage and Freshness: Global coverage and updated weekly with a 1-year validity
Types of Connections: Online, Interline, and Offline connections included
Number of Connections: Single (Leg1 & Leg2)
Try Flight Info Connections API for yourself by signing up for the Flight Info Trial.
January 7, 2022
Search by departure or arrival date range
Search by departure or arrival date range is now available in the Flight Info API. To use this feature, enter two dates separated with a slash, e.g., DepartureDate=2022-01-04/2022-01-11.
November 29, 2021
Instance view release of OAG's Flight Info Alerts
In this release, Flight Info Alerts API has moved from showing schedules in effective periods to showing them at the flight instance level. This provides a more granular view of flight schedules, whereby schedules are shown at the individual flight level. This will mean an increased volume of change events as changes are recorded for each individual flight instead of the effective period.
Flight Info Alerts enables customers to access near real-time change events in the full spectrum of schedules instance data that OAG holds without needing an API lookup. Flight Info Alerts allows users to configure which schedule changes they are interested in seeing at any combination of Date, Route, Airline and Flight Number Range.
Next iteration of the Flight Info API
The latest release of the Flight Info API is now available. Here users can look up flight information and see both schedules and status data, plus optional additional datasets such as predicted seats and actual seats, returned in the same response, displayed at the flight instance level. Additionally, users are able to retrieve more granular flight status output which shows all the status changes that happened for the returned flight.
The original version of the Flight Info API is now accessible as the Schedules API in the Developer Portal (API URL and schema remain unchanged).
May 4, 2021
Search by multiple airports
Search by multiple airports is now available in the Flight Info and Flight Changes APIs. To use this feature, enter comma-separated IATA airport codes in the DepartureAirport or ArrivalAirport parameters, e.g., DepartureAirport=LHR,LCY,LGW.
April 30, 2021
Initial release of OAG's Flight Info Alerts
The initial release introduces the Flight Info Alerts product.
Flight Info Alerts enables customers to access near real-time change events in the full spectrum of schedules data that OAG holds without needing an API lookup.
Flight Info Alerts allows users to configure which changes they are interested in and in what frequency.
April 21, 2021
On-Time Performance and other schedule data fields
This release delivers a wide range of new schedule data fields such as on-time performance, in-flight services, automated check-in, electronic ticketing, secure flight information, and government approval. The on-time performance fields present the percentage of arrivals that were on-time, late, and cancelled.
April 12, 2021
Calculated Seats Data
This release introduces seating capacity data by 5 cabins (first, business, premium economy, economy plus, and economy) and the total number of seats in Flight Info and Flight Changes APIs. The seats data is enhanced with the OAG Data Science model to provide the most accurate data.
Please contact the OAG sales team to buy or try calculated seats data.
January 29, 2021
Initial release of the Flight Info API and Developer Portal
The initial release introduces the OAG Developer Portal with the Flight Info and Flight Changes APIs.
Flight Info API enables customers to have direct, near real time access to the full spectrum of schedules data that OAG holds, allowing them to confidently view or present current schedule availability.
Flight Changes API allows users to retrieve schedules that were introduced, changed, or deleted from a specific date.