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/connect/flight/schedule>
Request Body Parameters
| Field Name | Data Type | Description | Sample Value | Required |
|---|---|---|---|---|
| external_id | string | A unique identifier for each flight. If you don’t have the global unique identifier, you can use any distinct string you want to be used upon update. | "XYZ12345ABC7890" | Yes |
| timestamp | isostring | The timestamp indicating when the flight information was last updated. | "2023-12-15T10:00:00Z" | Yes |
| fields | Object | See below Fields table | Yes |
Request Fields 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" | Yes |
| departureAirportIcao | string | The ICAO code of the departure airport. Must be in uppercase letters. | "KBOS" | Yes |
| arrivalAirportIcao | string | The ICAO code of the arrival airport. Must be in uppercase letters. | "KJFK" | Yes |
| 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" | Yes |
| 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 arrival time of the flight before any updates in ISO 8601 format. | "2023-12-15T12:00:00Z" | Yes |
| estimatedDepartureTime | isostring | The estimated departure time of the flight in ISO 8601 format. | "2023-12-15T09:00:00Z" | No |
| originalEstimatedDepartureTime | isostring | The departure time of the flight before any updates in ISO 8601 format. | "2023-12-15T08:30:00Z" | Yes |
Sample Data:
[{
"title": "Flight AA123",
"external_id": "AA123-20250331-JFK-LAX",
"timestamp": "2025-03-31T12:00:00Z",
"fields": {
"globalUniqueFlightIdentifier": "AA123-20250331-JFK-LAX",
"flightNumber": "AA123",
"airline": "American Airlines",
"aircraftType": "B738",
"departureAirportIcao": "KJFK",
"arrivalAirportIcao": "KLAX",
"estimatedDepartureTime": "2025-03-31T14:30:00Z",
"estimatedArrivalTime": "2025-03-31T17:45:00Z",
"originalEstimatedDepartureTime": "2025-03-31T14:15:00Z",
"originalEstimatedArrivalTime": "2025-03-31T17:30:00Z",
"status": "scheduled",
"updateTime": "2025-03-31T12:00:00Z"
}
},
{
"title": "Flight AA123",
"external_id": "AA123-20250331-JFK-LAX",
"timestamp": "2025-03-31T12:00:00Z",
"fields": {
"globalUniqueFlightIdentifier": "AA123-20250331-JFK-LAX",
"flightNumber": "AA123",
"airline": "American Airlines",
"aircraftType": "B738",
"departureAirportIcao": "KJFK",
"arrivalAirportIcao": "KLAX",
"originalEstimatedDepartureTime": "2025-03-31T14:15:00Z",
"originalEstimatedArrivalTime": "2025-03-31T17:30:00Z",
"status": "scheduled",
"updateTime": "2025-03-31T12:00:00Z"
}
}]
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.