Integrating your Flight Schedule

As part of our insight dashboard, we support visualization of flight schedules on monitored airports. We have the FAA SWIM scheduled flights already for the next 24 hours integrated into the platform for customers with flight schedules access. You can also integrate your own flight schedule into our platform to visualize takeoff and landing times in your insight dashboard and control the coverage and frequency of data updates.

Flight Schedule Display on Insights Dashboard

Endpoint

<https://api.tomorrow.io/v4/flights/schedule>

Request Body Parameters

Field Name	Data Type	Description	Sample Value	Required
globalUniqueFlightIdentifier	string	A unique identifier for each flight distinct from the flight number. It is specific to a proposed or airborne flight on a certain date. If you don’t have the global unique identifier, you can use any distinct string you want to be used upon update.	"XYZ12345ABC7890"	Yes
status	string	Flight status. Optional values: cancelled, scheduled	"cancelled"	No
departureAirportIcao	string	The ICAO code of the departure airport. Must be in uppercase letters.	"KBOS"	*No
arrivalAirportIcao	string	The ICAO code of the arrival airport. Must be in uppercase letters.	"KJFK"	*No
flightNumber	string	The flight number assigned by the airline in ICAO format.	"AA100"	Yes
airline	string	The iata code of the airline operating the flight.	"American Airlines"	No
aircraftType	string	The type of aircraft used for the flight.	"Boeing 737"	No
updateTime	isostring	The timestamp indicating when the flight information was last updated.	"2023-12-15T10:00:00Z"	Yes
estimatedArrivalTime	isostring	The estimated arrival time of the flight in ISO 8601 format.	"2023-12-15T12:30:00Z"	**No
originalEstimatedArrivalTime	isostring	The original estimated arrival time of the flight before any updates in ISO 8601 format.	"2023-12-15T12:00:00Z"	**No
estimatedDepartureTime	isostring	The estimated departure time of the flight in ISO 8601 format.	"2023-12-15T09:00:00Z"	**No
originalEstimatedDepartureTime	isostring	The original estimated departure time of the flight before any updates in ISO 8601 format.	"2023-12-15T08:30:00Z"	**No
position	object	The current position of the aircraft, applicable only for airborne flights. Includes latitude and longitude.	{ "type": "Point", "coordinates": [-71.060417, 42.358431] }	No
heading	double	The aircraft's current heading/direction, applicable only for airborne flights.	78.14259647369846	No

Note:

*At least one of departureAirportIcao or arrivalAirportIcao is required.

**At least one of estimatedDepartureTime OR originalEstimatedDepartureTime is required.
At least one of estimatedArrivalTime OR originalEstimatedArrivalTime is required.

Sample Data:

[{
    "globalUniqueFlightIdentifier": "a754c8dd-8e76-43d2-9aa4-6ea4d2b3d426",
    "flightNumber": "FFT770",
    "airline": "FFT",
    "aircraftType": "GL5T",
    "updateTime": "2023-07-24T08:02:00.000Z",
    "arrivalAirportIcao": "KDEN",
    "departureAirportIcao": "KLAS",
    "estimatedArrivalTime": "2023-07-23T09:35:00.000Z",
    "originalEstimatedArrivalTime": "2023-07-23T09:35:00.000Z",
    "originalEstimatedDepartureTime": "2023-07-23T08:02:00.000Z",
 "position": {
     "type": "Point",
     "coordinates": [
       -83.288611,
       40.078889
     ]
   },
  "heading": 141.62266659538102,
},
{
    "globalUniqueFlightIdentifier": "91435e4b-85ba-4998-9b14-46b0bd01992d",
    "flightNumber": "SWA3301",
    "departureAirportIcao": "KMIA",
    "originalEstimatedDepartureTime": "2023-07-23T10:25:00.000Z",
    "updateTime": "2023-07-24T08:02:00.000Z"
},
{
    "globalUniqueFlightIdentifier": "91435e4b-85ba-4998-9b14-46b0bd01992d",
    "flightNumber": "SWA3301",
    "arrivalAirportIcao": "KMIA",
    "estimatedArrivalTime": "2023-07-23T10:25:00.000Z",
    "updateTime": "2023-07-24T08:02:00.000Z"
}]

Integration Details

To integrate your data you need to have an authorized API key. Please reach out to your account manager to receive the authentication information and any additional integration details.