General Aviation as well as Unscheduled Data is now available as part of a Status Alerts subscription.
We have now released General Aviation and Unscheduled status data into Flight Info Alerts for customers subscribed to Status Alerts. Please note that this data is only specific for flights in the North America region.
Creating an Alert to track GA/Unscheduled Flights
Two new parameters have been added to alert creation, in order to start receiving GA/unscheduled flights in Flight Info Alerts. These are the gaFlights and unscheduledFlights boolean parameter:
{
"gaFlights": true,
"unscheduledFlights": true
}
In order to create an Alert that tracks either gaFlights, unscheduledFlights or both, a user must:
- Have an active status subscription.
- Have status set as true in the alert creation.
Here is an example of a correct Alert set to receive GA and unscheduled flights:
{
"alertId": "91f3aca3-5d66-4574-b507-89ed05406ad6",
"accountId": "d13b25ca-a071-4141-abf5-7d5d3897fbd5",
"name": "GA and Unscheduled Alert",
"description": "Sample GA and Unscheduled Alert",
"alertType": "port",
"departureAirport": "ATL",
"status": true,
"schedules": true,
"gaFlights": true,
"unscheduledFlights": true
}
Please note these nuances when creating such alerts:
- Although you can set gaFlights as true when creating a carrier alert, for the most part this will not make sense as commercial carriers are not typically classed as general aviation flights.
- It is not possible to create an alert with either gaFlights or unscheduledFlights set to true, if status is set to false. This is because General Aviation and Unscheduled flight data are by their nature, status events.
- It is technically possible to have an Alert with both schedules and status set to true, to track gaFlights or unscheduledFlights events as well as schedule changes, keeping in mind the other limitations above.
Data output for GA/Unscheduled Flights
By their nature, General Aviation and Unscheduled Flights may not have some of the 'expected' flight data, such as carrier code or flight number. Therefore, it is important that your application expects blanks or nulls for these fields when retrieving GA/Unscheduled flight data.
New fields/field values added
In order to allow users to parse these new flight types, we have added several data fields, as well as having new values for some existing fields. The table below should provide a guide to the changes:
New or Existing Field |
Field name | Description / Changes |
New | flightType | Used to distinguish between scheduled flights, GA flights, or unscheduled flights. These will be differentiated with the values "Scheduled", "GA" and "Unscheduled" respectively. |
Existing | state | A new flight state, "Proposed" has been added, which is similar to the "Scheduled" flight state of regular scheduled flights. |
Existing | flightNumber | General Aviation flights will always have a flight number value of 0. |
Existing | carrierCode>iata and carrierCode>icao | General Aviation flights will not have the carrierCode object or a value for its nested keys (iata/icao) as it is a null value. |
New | departure>airport>faa | The FAA code for the departure airport, when available. |
New | arrival>airport>faa | The FAA code for the arrival airport, when available. |
New | diversionAirport>faa | The FAA code for the diversion airport, when available. |
Here are some samples to illustrate the data structure of these flight types:
General Aviation Flight
{
"documentType": "FlightStatus",
"flightType": "GA",
"state": "Proposed",
"flightNumber": 0,
"equipment": {
"aircraftType": {
"iata": "CJ2",
"icao": "P32R"
},
"aircraftRegistrationNumber": "N53424"
},
"originationDate": {
"local": "2022-11-14T00:00:00"
},
"departure": {
"times": {
"scheduled": {
"local": "2024-05-03T09:55:00",
"utc": "2024-05-03T07:55:00"
},
"estimated": {
"outGateTimeliness": "Delayed",
"outGateVariation": "00:05:00",
"outGate": {
"local": "2024-05-03T10:00:00+02:00",
"utc": "2024-05-03T08:10:00+00:00"
},
"offGround": {
"local": "2024-05-03T11:10:00+02:00",
"utc": "2024-05-03T09:10:00+00:00"
}
},
"actual": {
"outGateTimeliness": "Delayed",
"outGateVariation": "00:15:00",
"outGate": {
"local": "2024-06-03T10:10:10+02:00",
"utc": "2024-06-03T08:10:10+00:00"
},
"offGround": {
"local": "2024-06-03T11:10:10+02:00",
"utc": "2024-06-03T09:10:10+00:00"
}
}
},
"airport": {
"iata": "YQB",
"icao": "CYQB",
"faa": "CYQB"
}
},
"arrival": {
"times": {
"scheduled": {
"local": "2024-07-03T15:10:00",
"utc": "2024-07-03T13:10:00"
},
"estimated": {
"inGateTimeliness": "Early",
"inGateVariation": "-00:04:00",
"inGate": {
"local": "2024-05-12T15:10:20+02:00",
"utc": "2024-05-12T13:10:20+00:00"
},
"onGround": {
"local": "2024-05-11T15:05:20+02:00",
"utc": "2024-05-11T13:10:20+00:00"
}
},
"actual": {
"inGateTimeliness": "OnTime",
"inGateVariation": "00:00:00",
"inGate": {
"local": "2024-05-04T15:10:00+02:00",
"utc": "2024-05-04T13:10:00+00:00"
},
"onGround": {
"local": "2024-05-03T15:10:00+02:00",
"utc": "2024-05-03T13:10:00+00:00"
}
}
},
"airport": {
"iata": "MSP",
"icao": "KMSP",
"faa": "MSP"
}
},
"diversionAirport": {
"iata": "PUW",
"icao": "KPUW",
"faa": "PUW"
},
"seatingCapacity": {
"firstClass": "1",
"businessClass": "123",
"premiumEconomyClass": "2",
"economyPlusClass": "4",
"economyClass": "10",
"totalSeats": "140"
},
"messageTimestamp": "1668358038210",
"messageId": "844b7593-845c-40e8-b4a3-f6d4d34f27d9",
"statusKey": "61dd824b499abd3677f750ed763d269cd812f26bcb1fa6658440a40e6227a39e",
"alertId": "2ce3ef54-3831-49c2-882a-ed2079ef9001"
}
Unscheduled Flight
{
"documentType": "FlightStatus",
"flightType": "Unscheduled",
"state": "InGate",
"serviceType": "G",
"flightNumber": 2131,
"carrierCode": {
"iata": "AC"
},
"equipment": {
"aircraftType": {
"iata": "77L",
"icao": "B77L"
}
},
"originationDate": {
"local": "2024-09-06T00:00:00"
},
"departure": {
"times": {
"scheduled": {
"local": "2024-09-06T21:20:00",
"utc": "2024-09-07T01:20:00"
},
"estimated": {
"outGateTimeliness": "Delayed",
"outGateVariation": "00:10:00",
"outGate": {
"local": "2024-09-06T21:30:00-04:00",
"utc": "2024-09-07T01:30:00+00:00"
},
"offGround": {
"local": "2024-09-06T21:51:00-04:00",
"utc": "2024-09-07T01:51:00+00:00"
}
},
"actual": {
"outGateTimeliness": "Delayed",
"outGateVariation": "00:09:00",
"outGate": {
"local": "2024-09-06T21:29:00-04:00",
"utc": "2024-09-07T01:29:00+00:00"
},
"offGround": {
"local": "2024-09-06T21:46:00-04:00",
"utc": "2024-09-07T01:46:00+00:00"
}
}
},
"airport": {
"iata": "YYZ",
"icao": "CYYZ",
"faa": "CYYZ"
},
"terminal": "T1",
"gate": "D41"
},
"arrival": {
"times": {
"scheduled": {
"local": "2024-09-06T23:20:00",
"utc": "2024-09-07T06:20:00"
},
"estimated": {
"inGateTimeliness": "Early",
"inGateVariation": "-00:06:00",
"inGate": {
"local": "2024-09-06T23:14:00-07:00",
"utc": "2024-09-07T06:14:00+00:00"
},
"onGround": {
"local": "2024-09-06T23:03:00-07:00",
"utc": "2024-09-07T06:03:00+00:00"
}
},
"actual": {
"inGateTimeliness": "Early",
"inGateVariation": "-00:07:00",
"inGate": {
"local": "2024-09-06T23:13:00-07:00",
"utc": "2024-09-07T06:13:00+00:00"
},
"onGround": {
"local": "2024-09-06T23:05:00-07:00",
"utc": "2024-09-07T06:05:00+00:00"
}
}
},
"airport": {
"iata": "YVR",
"icao": "CYVR",
"faa": "CYVR"
},
"terminal": "DTB",
"gate": "C51",
"baggage": "1"
},
"diversionAirport": {
"iata": "PUW",
"icao": "KPUW",
"faa": "PUW"
},
"seatingCapacity": {
"firstClass": "0",
"businessClass": "40",
"premiumEconomyClass": "24",
"economyPlusClass": "0",
"economyClass": "236",
"totalSeats": "300"
},
"messageTimestamp": "1662531345383",
"messageId": "73fbfef6-dbeb-43a9-a564-908574e2521a",
"statusKey": "fcd3e2317c2e302577991b467892968d908e705651130322eaae17d8c0d256bb",
"alertId": "016fe776-3aa5-4136-a390-f628783ed4da"
}