Alert Messages
Alert Messages are produced when an existing alert rule is triggered, and delivered to the destination specified by the rule. Currently, the only supported delivery mechanism is HTTP POST; this means you must have a running web server configured to accept POST requests to the delivery URL given in the rule.
Your web server will receive Alert Messages in your requested format, structured according to the specification below.
For creation of rules, see Alert Rule Creation.
Table of Contents
| Element | Cardinality | Description |
|---|---|---|
| <alert> | 1..1 | Holder element for an Alert Message |
| <event> | 1..1 | The event that has triggered the alert. |
| <type>PRE_DEPARTURE_STATUS</type> | 1..1 | The type of the event triggering the alert, see Alert Callback Events for a complete list. |
| <value>60</value> | 0..1 | Configured parameter value for events that accept or require additional specification. |
| </event> | ||
| <dataSource>FlightHistory</dataSource> | 1..1 | The source of the data from which the event was detected. |
| <dateTimeRecorded>2012-10-29T13:37:02.022Z</dateTimeRecorded> | 1..1 | The UTC date and time of the event in ISO-8601 format. yyyy-MM-dd'T'HH:mm:ss.SSSZ |
| <rule> ... </rule> | 1..1 | The Alert Rule that was triggered. |
| <flightStatus> ... </flightStatus> | 1..1 | The Flight Status that triggered the rule. |
| </alert> |
Events received via callback are related to the events registered during rule creation. However, the relationship between rules registered and events sent is not always one-to-one. The following table indicates the events received during callback and the relevant event codes that may result in the given alert.
For a complete list of events that can be registered see the Alert Event Fields
| Event | Triggering Event Code(s) | Notes |
|---|---|---|
| PRE_DEPARTURE_STATUS | preDep | Sent when the rule is subscribed for preDeparture alerts. The alert is sent relative to the scheduled depature time. |
| PRE_ARRIVAL_STATUS | preArr | Sent when the rule is subscribed for preArrival alerts. The alert is sent relative to the scheduled arrival time. |
| EN_ROUTE | any | When Cirium observes that the flight departs from the gate. |
| LANDED | any | When Cirium observes that the flight has landed. |
| CANCELLED | any | When Cirium observes that the flight has been cancelled. |
| DIVERTED | any | When Cirium observes that the flight has been diverted to another arrival airport. |
| DEPARTURE_DELAY | any | When Cirium observes a change in the departure time and the change meets the customer's depDelay or depDelayDelta criteria (note, despite the event name, this also applies if the time changes to depart early). |
| ARRIVAL_DELAY | any | When Cirium observes a change in the arrival time and the change meets the customer's arrDelay or arrDelayDelta criteria (note, despite the event name, this also applies if the time changes to arrive early). |
| BAGGAGE | any | When Cirium observes a change to the baggage location. |
| TIME_ADJUSTMENT | any | When Cirium observes a time change for a flight that isn't considered an ARRIVAL_DELAY or DEPARTURE_DELAY. Usually seen when subscribed for "all" events or when the time changes at the same time as a subscribed event (e.g. baggage and time change occurred in the same update). |
| DEPARTURE_GATE | any | When Cirium observes a change to the flight's departure gate. |
| ARRIVAL_GATE | any | When Cirium observes a change to the flight's arrival gate. |
| EQUIPMENT_ADJUSTMENT | any | Sent when Cirium observes a change in the tail number or equipment type for the flight. Be warned that this data is highly variable between data sources and is difficult to validate, so Cirium reports most of the observed changes. |
| UNKNOWN | The unknown event is sent when Cirium detects that there is little chance of being able to send events for the registered rule. This can happen if the flight is not scheduled or observed. |
The following example is a partial response and uses inline references for simplicity.
See Full Sample Responses for a complete response.
See Full Sample Responses for a complete response.
<alert>
<event>
<type>PRE_ARRIVAL_STATUS</type>
<value>15<value>
</event>
<dataSource>ASDI</dataSource>
<dateTimeRecorded>2012-10-29T13:50:34.717Z</dateTimeRecorded>
<rule>
<id>111710457</id>
<name>Default</name>
<carrier>
<fs>OO</fs>
<iata>OO</iata>
<icao>SKW</icao>
<name>SkyWest Airlines</name>
<active>true</active>
</carrier>
<flightNumber>4796</flightNumber>
<departureAirport>
<fs>LAX</fs>
<iata>LAX</iata>
<icao>KLAX</icao>
<faa>LAX</faa>
<name>Los Angeles International Airport</name>
<street1>One World Way</street1>
<street2></street2>
<city>Los Angeles</city>
<cityCode>LAX</cityCode>
<stateCode>CA</stateCode>
<postalCode>90045-5803</postalCode>
<countryCode>US</countryCode>
<countryName>United States</countryName>
<regionName>North America</regionName>
<timeZoneRegionName>America/Los_Angeles</timeZoneRegionName>
<weatherZone>CAZ041</weatherZone>
<localTime>2012-10-23T17:58:41.073</localTime>
<utcOffsetHours>-7.0</utcOffsetHours>
<latitude>33.943399</latitude>
<longitude>-118.408279</longitude>
<elevationFeet>126</elevationFeet>
<classification>1</classification>
<active>true</active>
<delayIndexUrl>https://api.flightstats.com/flex/delayindex/rest/v1/json/airports/LAX?codeType=fs
</delayIndexUrl>
<weatherUrl>https://api.flightstats.com/flex/weather/rest/v1/json/all/LAX?codeType=fs</weatherUrl>
</departureAirport>
<arrivalAirport>
<fs>PHX</fs>
<iata>PHX</iata>
<icao>KPHX</icao>
<faa>PHX</faa>
<name>Sky Harbor International Airport</name>
<street1>3400 Sky Harbor Boulevard</street1>
<street2></street2>
<city>Phoenix</city>
<cityCode>PHX</cityCode>
<stateCode>AZ</stateCode>
<postalCode>85034</postalCode>
<countryCode>US</countryCode>
<countryName>United States</countryName>
<regionName>North America</regionName>
<timeZoneRegionName>America/Phoenix</timeZoneRegionName>
<weatherZone>AZZ023</weatherZone>
<localTime>2012-10-23T17:58:41.074</localTime>
<utcOffsetHours>-7.0</utcOffsetHours>
<latitude>33.435036</latitude>
<longitude>-112.000164</longitude>
<elevationFeet>1135</elevationFeet>
<classification>1</classification>
<active>true</active>
<delayIndexUrl>https://api.flightstats.com/flex/delayindex/rest/v1/json/airports/PHX?codeType=fs
</delayIndexUrl>
<weatherUrl>https://api.flightstats.com/flex/weather/rest/v1/json/all/PHX?codeType=fs</weatherUrl>
</arrivalAirport>
<departure>2012-10-23T17:00:00.000</departure>
<arrival>2012-10-23T18:31:00.000</arrival>
<ruleEvents>
<ruleEvent>
<type>ALL_CHANGES</type>
</ruleEvent>
</ruleEvents>
<nameValues>
<nameValue>
<name>customName</name>
<value>customValue</value>
</nameValue>
</nameValues>
<delivery>
<format>XML</format>
<destination>http://example.com/callback</destination>
</delivery>
</rule>
<flightStatus>
<flightId>278381603</flightId>
<carrier>
<fs>OO</fs>
<iata>OO</iata>
<icao>SKW</icao>
<name>SkyWest Airlines</name>
<active>true</active>
</carrier>
<flightNumber>4796</flightNumber>
<departureAirport>
<fs>LAX</fs>
<iata>LAX</iata>
<icao>KLAX</icao>
<faa>LAX</faa>
<name>Los Angeles International Airport</name>
<street1>One World Way</street1>
<street2></street2>
<city>Los Angeles</city>
<cityCode>LAX</cityCode>
<stateCode>CA</stateCode>
<postalCode>90045-5803</postalCode>
<countryCode>US</countryCode>
<countryName>United States</countryName>
<regionName>North America</regionName>
<timeZoneRegionName>America/Los_Angeles</timeZoneRegionName>
<weatherZone>CAZ041</weatherZone>
<localTime>2012-10-23T17:58:41.074</localTime>
<utcOffsetHours>-7.0</utcOffsetHours>
<latitude>33.943399</latitude>
<longitude>-118.408279</longitude>
<elevationFeet>126</elevationFeet>
<classification>1</classification>
<active>true</active>
<delayIndexUrl>https://api.flightstats.com/flex/delayindex/rest/v1/json/airports/LAX?codeType=fs
</delayIndexUrl>
<weatherUrl>https://api.flightstats.com/flex/weather/rest/v1/json/all/LAX?codeType=fs</weatherUrl>
</departureAirport>
<arrivalAirport>
<fs>PHX</fs>
<iata>PHX</iata>
<icao>KPHX</icao>
<faa>PHX</faa>
<name>Sky Harbor International Airport</name>
<street1>3400 Sky Harbor Boulevard</street1>
<street2></street2>
<city>Phoenix</city>
<cityCode>PHX</cityCode>
<stateCode>AZ</stateCode>
<postalCode>85034</postalCode>
<countryCode>US</countryCode>
<countryName>United States</countryName>
<regionName>North America</regionName>
<timeZoneRegionName>America/Phoenix</timeZoneRegionName>
<weatherZone>AZZ023</weatherZone>
<localTime>2012-10-23T17:58:41.074</localTime>
<utcOffsetHours>-7.0</utcOffsetHours>
<latitude>33.435036</latitude>
<longitude>-112.000164</longitude>
<elevationFeet>1135</elevationFeet>
<classification>1</classification>
<active>true</active>
<delayIndexUrl>https://api.flightstats.com/flex/delayindex/rest/v1/json/airports/PHX?codeType=fs
</delayIndexUrl>
<weatherUrl>https://api.flightstats.com/flex/weather/rest/v1/json/all/PHX?codeType=fs</weatherUrl>
</arrivalAirport>
<departureDate>
<dateLocal>2012-10-23T17:00:00.000</dateLocal>
<dateUtc>2012-10-24T00:00:00.000Z</dateUtc>
</departureDate>
<arrivalDate>
<dateLocal>2012-10-23T18:31:00.000</dateLocal>
<dateUtc>2012-10-24T01:31:00.000Z</dateUtc>
</arrivalDate>
<flightStatus>A</flightStatus>
<schedule>
<flightType>J</flightType>
<serviceClasses>FY</serviceClasses>
<restrictions></restrictions>
<downlines>
<downline>
<arrivalAirport>
<fs>LAX</fs>
<iata>LAX</iata>
<icao>KLAX</icao>
<faa>LAX</faa>
<name>Los Angeles International Airport</name>
<street1>One World Way</street1>
<street2></street2>
<city>Los Angeles</city>
<cityCode>LAX</cityCode>
<stateCode>CA</stateCode>
<postalCode>90045-5803</postalCode>
<countryCode>US</countryCode>
<countryName>United States</countryName>
<regionName>North America</regionName>
<timeZoneRegionName>America/Los_Angeles</timeZoneRegionName>
<weatherZone>CAZ041</weatherZone>
<localTime>2012-10-23T17:58:41.074</localTime>
<utcOffsetHours>-7.0</utcOffsetHours>
<latitude>33.943399</latitude>
<longitude>-118.408279</longitude>
<elevationFeet>126</elevationFeet>
<classification>1</classification>
<active>true</active>
<delayIndexUrl>https://api.flightstats.com/flex/delayindex/rest/v1/json/airports/LAX?codeType=fs
</delayIndexUrl>
<weatherUrl>https://api.flightstats.com/flex/weather/rest/v1/json/all/LAX?codeType=fs
</weatherUrl>
</arrivalAirport>
<flightId>278400809</flightId>
</downline>
</downlines>
</schedule>
<operationalTimes>
<publishedDeparture>
<dateLocal>2012-10-23T17:00:00.000</dateLocal>
<dateUtc>2012-10-24T00:00:00.000Z</dateUtc>
</publishedDeparture>
<publishedArrival>
<dateLocal>2012-10-23T18:31:00.000</dateLocal>
<dateUtc>2012-10-24T01:31:00.000Z</dateUtc>
</publishedArrival>
<scheduledGateDeparture>
<dateLocal>2012-10-23T17:00:00.000</dateLocal>
<dateUtc>2012-10-24T00:00:00.000Z</dateUtc>
</scheduledGateDeparture>
<actualGateDeparture>
<dateLocal>2012-10-23T16:58:00.000</dateLocal>
<dateUtc>2012-10-23T23:58:00.000Z</dateUtc>
</actualGateDeparture>
<flightPlanPlannedDeparture>
<dateLocal>2012-10-23T17:22:00.000</dateLocal>
<dateUtc>2012-10-24T00:22:00.000Z</dateUtc>
</flightPlanPlannedDeparture>
<estimatedRunwayDeparture>
<dateLocal>2012-10-23T17:18:00.000</dateLocal>
<dateUtc>2012-10-24T00:18:00.000Z</dateUtc>
</estimatedRunwayDeparture>
<actualRunwayDeparture>
<dateLocal>2012-10-23T17:18:00.000</dateLocal>
<dateUtc>2012-10-24T00:18:00.000Z</dateUtc>
</actualRunwayDeparture>
<scheduledGateArrival>
<dateLocal>2012-10-23T18:31:00.000</dateLocal>
<dateUtc>2012-10-24T01:31:00.000Z</dateUtc>
</scheduledGateArrival>
<estimatedGateArrival>
<dateLocal>2012-10-23T18:14:00.000</dateLocal>
<dateUtc>2012-10-24T01:14:00.000Z</dateUtc>
</estimatedGateArrival>
<flightPlanPlannedArrival>
<dateLocal>2012-10-23T18:25:00.000</dateLocal>
<dateUtc>2012-10-24T01:25:00.000Z</dateUtc>
</flightPlanPlannedArrival>
<estimatedRunwayArrival>
<dateLocal>2012-10-23T18:16:00.000</dateLocal>
<dateUtc>2012-10-24T01:16:00.000Z</dateUtc>
</estimatedRunwayArrival>
</operationalTimes>
<codeshares>
<codeshare>
<carrier>
<fs>DL</fs>
<iata>DL</iata>
<icao>DAL</icao>
<name>Delta Air Lines</name>
<phoneNumber>1-800-221-1212</phoneNumber>
<active>true</active>
</carrier>
<flightNumber>4796</flightNumber>
<relationship>X</relationship>
</codeshare>
<codeshare>
<carrier>
<fs>KL</fs>
<iata>KL</iata>
<icao>KLM</icao>
<name>KLM</name>
<active>true</active>
</carrier>
<flightNumber>7792</flightNumber>
<relationship>Z</relationship>
</codeshare>
<codeshare>
<carrier>
<fs>VA</fs>
<iata>VA</iata>
<icao>VAU</icao>
<name>V Australia</name>
<active>true</active>
</carrier>
<flightNumber>6666</flightNumber>
<relationship>Z</relationship>
</codeshare>
<codeshare>
<carrier>
<fs>MU</fs>
<iata>MU</iata>
<icao>CES</icao>
<name>China Eastern Airlines</name>
<active>true</active>
</carrier>
<flightNumber>8845</flightNumber>
<relationship>L</relationship>
</codeshare>
<codeshare>
<carrier>
<fs>AZ</fs>
<iata>AZ</iata>
<icao>AZA</icao>
<name>Alitalia</name>
<active>true</active>
</carrier>
<flightNumber>3203</flightNumber>
<relationship>L</relationship>
</codeshare>
<codeshare>
<carrier>
<fs>AS</fs>
<iata>AS</iata>
<icao>ASA</icao>
<name>Alaska Airlines</name>
<phoneNumber>1-800-252-7522</phoneNumber>
<active>true</active>
</carrier>
<flightNumber>6725</flightNumber>
<relationship>Z</relationship>
</codeshare>
</codeshares>
<flightDurations>
<scheduledBlockMinutes>91</scheduledBlockMinutes>
<scheduledAirMinutes>63</scheduledAirMinutes>
<scheduledTaxiOutMinutes>22</scheduledTaxiOutMinutes>
<taxiOutMinutes>20</taxiOutMinutes>
<scheduledTaxiInMinutes>6</scheduledTaxiInMinutes>
</flightDurations>
<airportResources>
<departureTerminal>5</departureTerminal>
<departureGate>55A</departureGate>
<arrivalTerminal>3</arrivalTerminal>
<arrivalGate>16</arrivalGate>
</airportResources>
<flightEquipment>
<scheduledEquipment>
<iata>CR9</iata>
<name>Canadair (Bombardier) Regional Jet 900 and Challenger 890</name>
<turboProp>false</turboProp>
<jet>true</jet>
<widebody>false</widebody>
<regional>true</regional>
</scheduledEquipment>
<actualEquipment>
<iata>CRJ9</iata>
<name>??</name>
<turboProp>false</turboProp>
<jet>false</jet>
<widebody>false</widebody>
<regional>false</regional>
</actualEquipment>
</flightEquipment>
<flightStatusUpdates>
<flightStatusUpdate>
<updatedAt>
<dateUtc>2012-10-22T17:11:09.079-07:00</dateUtc>
</updatedAt>
<source>ASDI</source>
<updatedDateFields>
<updatedDateField>
<field>SRD</field>
<newDateLocal>2012-10-23T17:22:00.000</newDateLocal>
</updatedDateField>
<updatedDateField>
<field>ERD</field>
<newDateLocal>2012-10-23T17:22:00.000</newDateLocal>
</updatedDateField>
<updatedDateField>
<field>SRA</field>
<newDateLocal>2012-10-23T18:25:00.000</newDateLocal>
</updatedDateField>
<updatedDateField>
<field>ERA</field>
<newDateLocal>2012-10-23T18:25:00.000</newDateLocal>
</updatedDateField>
</updatedDateFields>
</flightStatusUpdate>
<flightStatusUpdate>
<updatedAt>
<dateUtc>2012-10-22T19:11:04.810-07:00</dateUtc>
</updatedAt>
<source>Airline</source>
<updatedTextFields>
<updatedTextField>
<field>DGT</field>
<newText>50B</newText>
</updatedTextField>
<updatedTextField>
<field>AGT</field>
<newText>16</newText>
</updatedTextField>
</updatedTextFields>
</flightStatusUpdate>
<flightStatusUpdate>
<updatedAt>
<dateUtc>2012-10-23T05:13:06.874-07:00</dateUtc>
</updatedAt>
<source>Airline</source>
<updatedTextFields>
<updatedTextField>
<field>DGT</field>
<originalText>50B</originalText>
<newText>54B</newText>
</updatedTextField>
</updatedTextFields>
</flightStatusUpdate>
<flightStatusUpdate>
<updatedAt>
<dateUtc>2012-10-23T16:12:45.823-07:00</dateUtc>
</updatedAt>
<source>ASDI</source>
<updatedDateFields>
<updatedDateField>
<field>ERD</field>
<originalDateLocal>2012-10-23T17:22:00.000</originalDateLocal>
<newDateLocal>2012-10-23T17:14:00.000</newDateLocal>
</updatedDateField>
<updatedDateField>
<field>ERA</field>
<originalDateLocal>2012-10-23T18:25:00.000</originalDateLocal>
<newDateLocal>2012-10-23T18:03:00.000</newDateLocal>
</updatedDateField>
</updatedDateFields>
</flightStatusUpdate>
<flightStatusUpdate>
<updatedAt>
<dateUtc>2012-10-23T16:14:26.286-07:00</dateUtc>
</updatedAt>
<source>Airline</source>
<updatedTextFields>
<updatedTextField>
<field>DGT</field>
<originalText>54B</originalText>
<newText>55A</newText>
</updatedTextField>
</updatedTextFields>
</flightStatusUpdate>
<flightStatusUpdate>
<updatedAt>
<dateUtc>2012-10-23T16:36:26.998-07:00</dateUtc>
</updatedAt>
<source>Sabre (DL)</source>
<updatedDateFields>
<updatedDateField>
<field>EGA</field>
<newDateLocal>2012-10-23T18:11:00.000</newDateLocal>
</updatedDateField>
</updatedDateFields>
</flightStatusUpdate>
<flightStatusUpdate>
<updatedAt>
<dateUtc>2012-10-23T17:03:58.278-07:00</dateUtc>
</updatedAt>
<source>Sabre (DL)</source>
<updatedTextFields>
<updatedTextField>
<field>STS</field>
<originalText>S</originalText>
<newText>A</newText>
</updatedTextField>
</updatedTextFields>
<updatedDateFields>
<updatedDateField>
<field>AGD</field>
<newDateLocal>2012-10-23T16:58:00.000</newDateLocal>
</updatedDateField>
<updatedDateField>
<field>EGA</field>
<originalDateLocal>2012-10-23T18:11:00.000</originalDateLocal>
<newDateLocal>2012-10-23T18:09:00.000</newDateLocal>
</updatedDateField>
</updatedDateFields>
</flightStatusUpdate>
<flightStatusUpdate>
<updatedAt>
<dateUtc>2012-10-23T17:23:37.092-07:00</dateUtc>
</updatedAt>
<source>ASDI</source>
<updatedDateFields>
<updatedDateField>
<field>ERD</field>
<originalDateLocal>2012-10-23T17:14:00.000</originalDateLocal>
<newDateLocal>2012-10-23T17:18:00.000</newDateLocal>
</updatedDateField>
<updatedDateField>
<field>ERA</field>
<originalDateLocal>2012-10-23T18:03:00.000</originalDateLocal>
<newDateLocal>2012-10-23T18:22:00.000</newDateLocal>
</updatedDateField>
</updatedDateFields>
</flightStatusUpdate>
<flightStatusUpdate>
<updatedAt>
<dateUtc>2012-10-23T17:23:37.109-07:00</dateUtc>
</updatedAt>
<source>ASDI</source>
<updatedTextFields>
<updatedTextField>
<field>AQP</field>
<newText>CRJ9</newText>
</updatedTextField>
</updatedTextFields>
</flightStatusUpdate>
<flightStatusUpdate>
<updatedAt>
<dateUtc>2012-10-23T17:24:07.245-07:00</dateUtc>
</updatedAt>
<source>ASDI</source>
<updatedDateFields>
<updatedDateField>
<field>ARD</field>
<newDateLocal>2012-10-23T17:18:00.000</newDateLocal>
</updatedDateField>
</updatedDateFields>
</flightStatusUpdate>
<flightStatusUpdate>
<updatedAt>
<dateUtc>2012-10-23T17:35:17.610-07:00</dateUtc>
</updatedAt>
<source>Sabre (DL)</source>
<updatedDateFields>
<updatedDateField>
<field>ARD</field>
<originalDateLocal>2012-10-23T17:18:00.000</originalDateLocal>
<newDateLocal>2012-10-23T17:17:00.000</newDateLocal>
</updatedDateField>
<updatedDateField>
<field>EGA</field>
<originalDateLocal>2012-10-23T18:09:00.000</originalDateLocal>
<newDateLocal>2012-10-23T18:14:00.000</newDateLocal>
</updatedDateField>
</updatedDateFields>
</flightStatusUpdate>
<flightStatusUpdate>
<updatedAt>
<dateUtc>2012-10-23T17:40:44.330-07:00</dateUtc>
</updatedAt>
<source>ASDI</source>
<updatedDateFields>
<updatedDateField>
<field>ARD</field>
<originalDateLocal>2012-10-23T17:17:00.000</originalDateLocal>
<newDateLocal>2012-10-23T17:18:00.000</newDateLocal>
</updatedDateField>
<updatedDateField>
<field>ERA</field>
<originalDateLocal>2012-10-23T18:22:00.000</originalDateLocal>
<newDateLocal>2012-10-23T18:15:00.000</newDateLocal>
</updatedDateField>
</updatedDateFields>
</flightStatusUpdate>
<flightStatusUpdate>
<updatedAt>
<dateUtc>2012-10-23T17:43:55.961-07:00</dateUtc>
</updatedAt>
<source>ASDI</source>
<updatedDateFields>
<updatedDateField>
<field>ERA</field>
<originalDateLocal>2012-10-23T18:15:00.000</originalDateLocal>
<newDateLocal>2012-10-23T18:16:00.000</newDateLocal>
</updatedDateField>
</updatedDateFields>
</flightStatusUpdate>
<flightStatusUpdate>
<updatedAt>
<dateUtc>2012-10-23T17:55:04.294-07:00</dateUtc>
</updatedAt>
<source>ASDI</source>
<updatedDateFields>
<updatedDateField>
<field>ERA</field>
<originalDateLocal>2012-10-23T18:16:00.000</originalDateLocal>
<newDateLocal>2012-10-23T18:15:00.000</newDateLocal>
</updatedDateField>
</updatedDateFields>
</flightStatusUpdate>
<flightStatusUpdate>
<updatedAt>
<dateUtc>2012-10-23T17:55:37.729-07:00</dateUtc>
</updatedAt>
<source>Sabre (DL)</source>
<updatedDateFields>
<updatedDateField>
<field>ARD</field>
<originalDateLocal>2012-10-23T17:18:00.000</originalDateLocal>
<newDateLocal>2012-10-23T17:17:00.000</newDateLocal>
</updatedDateField>
</updatedDateFields>
</flightStatusUpdate>
<flightStatusUpdate>
<updatedAt>
<dateUtc>2012-10-23T17:58:13.904-07:00</dateUtc>
</updatedAt>
<source>ASDI</source>
<updatedDateFields>
<updatedDateField>
<field>ARD</field>
<originalDateLocal>2012-10-23T17:17:00.000</originalDateLocal>
<newDateLocal>2012-10-23T17:18:00.000</newDateLocal>
</updatedDateField>
<updatedDateField>
<field>ERA</field>
<originalDateLocal>2012-10-23T18:15:00.000</originalDateLocal>
<newDateLocal>2012-10-23T18:16:00.000</newDateLocal>
</updatedDateField>
</updatedDateFields>
</flightStatusUpdate>
</flightStatusUpdates>
</flightStatus>
</alert>
The following example is a partial response and uses inline references for simplicity.
See Full Sample Responses for a complete response.
See Full Sample Responses for a complete response.
{
"alert": {
"dataSource": "FlightHistory",
"dateTimeRecorded": "2012-10-29T13:37:02.022Z",
"event": {
"type": "PRE_ARRIVAL_STATUS",
"value": "15"
},
"flightStatus": {
"airportResources": {
"arrivalGate": "27",
"arrivalTerminal": "B",
"departureGate": "16",
"departureTerminal": "C"
},
"arrivalAirport": {
"active": "true",
"city": "San Jose",
"cityCode": "SJC",
"classification": "2",
"countryCode": "US",
"countryName": "United States",
"delayIndexUrl": "https://api.flightstats.com/flex/delayindex/rest/v1/json/airports/SJC?codeType=fs",
"elevationFeet": "58",
"faa": "SJC",
"fs": "SJC",
"iata": "SJC",
"icao": "KSJC",
"latitude": "37.366736",
"localTime": "2012-10-23T17:58:41.143",
"longitude": "-121.926375",
"name": "Norman Y. Mineta San Jose International Airport",
"postalCode": "95110",
"regionName": "North America",
"stateCode": "CA",
"street1": "1701 Airport Boulevard, Suite B-1130",
"timeZoneRegionName": "America/Los_Angeles",
"utcOffsetHours": "-7.0",
"weatherUrl": "https://api.flightstats.com/flex/weather/rest/v1/json/all/SJC?codeType=fs",
"weatherZone": "CAZ513"
},
"arrivalDate": {
"dateLocal": "2012-10-23T18:11:00.000",
"dateUtc": "2012-10-24T01:11:00.000Z"
},
"carrier": {
"active": "true",
"fs": "AS",
"iata": "AS",
"icao": "ASA",
"name": "Alaska Airlines",
"phoneNumber": "1-800-252-7522"
},
"codeshares": {
"codeshare": [
{
"carrier": {
"active": "true",
"fs": "KE",
"iata": "KE",
"icao": "KAL",
"name": "Korean Air"
},
"flightNumber": "6127",
"relationship": "L"
},
{
"carrier": {
"active": "true",
"fs": "DL",
"iata": "DL",
"icao": "DAL",
"name": "Delta Air Lines",
"phoneNumber": "1-800-221-1212"
},
"flightNumber": "9213",
"relationship": "L"
},
{
"carrier": {
"active": "true",
"fs": "KL",
"iata": "KL",
"icao": "KLM",
"name": "KLM"
},
"flightNumber": "8234",
"relationship": "L"
},
{
"carrier": {
"active": "true",
"fs": "AA",
"iata": "AA",
"icao": "AAL",
"name": "American Airlines",
"phoneNumber": "1-800-433-7300"
},
"flightNumber": "7009",
"relationship": "L"
},
{
"carrier": {
"active": "true",
"fs": "AF",
"iata": "AF",
"icao": "AFR",
"name": "Air France",
"phoneNumber": "1-800-237-2747"
},
"flightNumber": "9642",
"relationship": "L"
}
]
},
"delays": {
"arrivalRunwayDelayMinutes": "4"
},
"departureAirport": {
"active": "true",
"city": "Seattle",
"cityCode": "SEA",
"classification": "1",
"countryCode": "US",
"countryName": "United States",
"delayIndexUrl": "https://api.flightstats.com/flex/delayindex/rest/v1/json/airports/SEA?codeType=fs",
"elevationFeet": "429",
"faa": "SEA",
"fs": "SEA",
"iata": "SEA",
"icao": "KSEA",
"latitude": "47.443839",
"localTime": "2012-10-23T17:58:41.143",
"longitude": "-122.301732",
"name": "Seattle/Tacoma International Airport",
"postalCode": "98158",
"regionName": "North America",
"stateCode": "WA",
"street1": "",
"street2": "",
"timeZoneRegionName": "America/Los_Angeles",
"utcOffsetHours": "-7.0",
"weatherUrl": "https://api.flightstats.com/flex/weather/rest/v1/json/all/SEA?codeType=fs",
"weatherZone": "WAZ001"
},
"departureDate": {
"dateLocal": "2012-10-23T16:05:00.000",
"dateUtc": "2012-10-23T23:05:00.000Z"
},
"flightDurations": {
"scheduledAirMinutes": "101",
"scheduledBlockMinutes": "126",
"scheduledTaxiInMinutes": "18",
"scheduledTaxiOutMinutes": "7",
"taxiOutMinutes": "12"
},
"flightEquipment": {
"actualEquipment": {
"iata": "B734",
"jet": "false",
"name": "??",
"regional": "false",
"turboProp": "false",
"widebody": "false"
},
"scheduledEquipment": {
"iata": "734",
"jet": "true",
"name": "Boeing 737-400 Passenger",
"regional": "false",
"turboProp": "false",
"widebody": "false"
}
},
"flightId": "278406954",
"flightNumber": "328",
"flightStatusUpdates": {
"flightStatusUpdate": [
{
"source": "Airline Direct (AS)",
"updatedAt": {
"dateUtc": "2012-10-22T10:00:32.137-07:00"
},
"updatedDateFields": {
"updatedDateField": [
{
"field": "EGD",
"newDateLocal": "2012-10-23T16:05:00.000"
},
{
"field": "EGA",
"newDateLocal": "2012-10-23T18:11:00.000"
}
]
},
"updatedTextFields": {
"updatedTextField": [
{
"field": "DTM",
"newText": "C"
},
{
"field": "DGT",
"newText": "11"
},
{
"field": "AGT",
"newText": "27"
},
{
"field": "TAL",
"newText": "N705AS"
}
]
}
},
{
"source": "ASDI",
"updatedAt": {
"dateUtc": "2012-10-22T16:10:59.887-07:00"
},
"updatedDateFields": {
"updatedDateField": [
{
"field": "SRD",
"newDateLocal": "2012-10-23T16:12:00.000"
},
{
"field": "ERD",
"newDateLocal": "2012-10-23T16:12:00.000"
},
{
"field": "SRA",
"newDateLocal": "2012-10-23T17:53:00.000"
},
{
"field": "ERA",
"newDateLocal": "2012-10-23T17:53:00.000"
}
]
}
},
{
"source": "Airline Direct (AS)",
"updatedAt": {
"dateUtc": "2012-10-23T09:39:43.763-07:00"
},
"updatedTextFields": {
"updatedTextField": {
"field": "DGT",
"newText": "15",
"originalText": "11"
}
}
},
{
"source": "Airline Direct (AS)",
"updatedAt": {
"dateUtc": "2012-10-23T09:40:47.293-07:00"
},
"updatedTextFields": {
"updatedTextField": {
"field": "DGT",
"newText": "16",
"originalText": "15"
}
}
},
{
"source": "ASDI",
"updatedAt": {
"dateUtc": "2012-10-23T15:14:52.009-07:00"
},
"updatedDateFields": {
"updatedDateField": {
"field": "ERA",
"newDateLocal": "2012-10-23T17:55:00.000",
"originalDateLocal": "2012-10-23T17:53:00.000"
}
}
},
{
"source": "Airline Direct (AS)",
"updatedAt": {
"dateUtc": "2012-10-23T16:10:35.706-07:00"
},
"updatedDateFields": {
"updatedDateField": [
{
"field": "AGD",
"newDateLocal": "2012-10-23T15:58:00.000"
},
{
"field": "EGA",
"newDateLocal": "2012-10-23T18:02:00.000",
"originalDateLocal": "2012-10-23T18:11:00.000"
}
]
},
"updatedTextFields": {
"updatedTextField": {
"field": "STS",
"newText": "A",
"originalText": "S"
}
}
},
{
"source": "ASDI",
"updatedAt": {
"dateUtc": "2012-10-23T16:16:03.777-07:00"
},
"updatedDateFields": {
"updatedDateField": [
{
"field": "ERD",
"newDateLocal": "2012-10-23T16:10:00.000",
"originalDateLocal": "2012-10-23T16:12:00.000"
},
{
"field": "ERA",
"newDateLocal": "2012-10-23T17:53:00.000",
"originalDateLocal": "2012-10-23T17:55:00.000"
}
]
}
},
{
"source": "ASDI",
"updatedAt": {
"dateUtc": "2012-10-23T16:16:03.791-07:00"
},
"updatedTextFields": {
"updatedTextField": {
"field": "AQP",
"newText": "B734"
}
}
},
{
"source": "ASDI",
"updatedAt": {
"dateUtc": "2012-10-23T16:16:05.929-07:00"
},
"updatedDateFields": {
"updatedDateField": {
"field": "ARD",
"newDateLocal": "2012-10-23T16:10:00.000"
}
}
},
{
"source": "ASDI",
"updatedAt": {
"dateUtc": "2012-10-23T17:11:05.090-07:00"
},
"updatedDateFields": {
"updatedDateField": {
"field": "ERA",
"newDateLocal": "2012-10-23T17:54:00.000",
"originalDateLocal": "2012-10-23T17:53:00.000"
}
}
},
{
"source": "ASDI",
"updatedAt": {
"dateUtc": "2012-10-23T17:20:52.618-07:00"
},
"updatedDateFields": {
"updatedDateField": {
"field": "ERA",
"newDateLocal": "2012-10-23T17:53:00.000",
"originalDateLocal": "2012-10-23T17:54:00.000"
}
}
},
{
"source": "ASDI",
"updatedAt": {
"dateUtc": "2012-10-23T17:54:34.416-07:00"
},
"updatedDateFields": {
"updatedDateField": {
"field": "ERA",
"newDateLocal": "2012-10-23T17:52:00.000",
"originalDateLocal": "2012-10-23T17:53:00.000"
}
}
},
{
"source": "ASDI",
"updatedAt": {
"dateUtc": "2012-10-23T17:58:18.867-07:00"
},
"updatedDateFields": {
"updatedDateField": {
"field": "ERA",
"newDateLocal": "2012-10-23T17:57:00.000",
"originalDateLocal": "2012-10-23T17:52:00.000"
}
}
}
]
},
"operationalTimes": {
"actualGateDeparture": {
"dateLocal": "2012-10-23T15:58:00.000",
"dateUtc": "2012-10-23T22:58:00.000Z"
},
"actualRunwayDeparture": {
"dateLocal": "2012-10-23T16:10:00.000",
"dateUtc": "2012-10-23T23:10:00.000Z"
},
"estimatedGateArrival": {
"dateLocal": "2012-10-23T18:02:00.000",
"dateUtc": "2012-10-24T01:02:00.000Z"
},
"estimatedGateDeparture": {
"dateLocal": "2012-10-23T16:05:00.000",
"dateUtc": "2012-10-23T23:05:00.000Z"
},
"estimatedRunwayArrival": {
"dateLocal": "2012-10-23T17:57:00.000",
"dateUtc": "2012-10-24T00:57:00.000Z"
},
"estimatedRunwayDeparture": {
"dateLocal": "2012-10-23T16:10:00.000",
"dateUtc": "2012-10-23T23:10:00.000Z"
},
"flightPlanPlannedArrival": {
"dateLocal": "2012-10-23T17:53:00.000",
"dateUtc": "2012-10-24T00:53:00.000Z"
},
"flightPlanPlannedDeparture": {
"dateLocal": "2012-10-23T16:12:00.000",
"dateUtc": "2012-10-23T23:12:00.000Z"
},
"publishedArrival": {
"dateLocal": "2012-10-23T18:11:00.000",
"dateUtc": "2012-10-24T01:11:00.000Z"
},
"publishedDeparture": {
"dateLocal": "2012-10-23T16:05:00.000",
"dateUtc": "2012-10-23T23:05:00.000Z"
},
"scheduledGateArrival": {
"dateLocal": "2012-10-23T18:11:00.000",
"dateUtc": "2012-10-24T01:11:00.000Z"
},
"scheduledGateDeparture": {
"dateLocal": "2012-10-23T16:05:00.000",
"dateUtc": "2012-10-23T23:05:00.000Z"
}
},
"schedule": {
"flightType": "J",
"restrictions": "",
"serviceClasses": "FY"
},
"status": "A"
},
"rule": {
"arrival": "2012-10-23T18:11:00.000",
"arrivalAirport": {
"active": "true",
"city": "San Jose",
"cityCode": "SJC",
"classification": "2",
"countryCode": "US",
"countryName": "United States",
"delayIndexUrl": "https://api.flightstats.com/flex/delayindex/rest/v1/json/airports /SJC?codeType=fs",
"elevationFeet": "58",
"faa": "SJC",
"fs": "SJC",
"iata": "SJC",
"icao": "KSJC",
"latitude": "37.366736",
"localTime": "2012-10-23T17:58:41.143",
"longitude": "-121.926375",
"name": "Norman Y. Mineta San Jose International Airport",
"postalCode": "95110",
"regionName": "North America",
"stateCode": "CA",
"street1": "1701 Airport Boulevard, Suite B-1130",
"timeZoneRegionName": "America/Los_Angeles",
"utcOffsetHours": "-7.0",
"weatherUrl": "https://api.flightstats.com/flex/weather/rest/v1/json/all/SJC?codeType=fs",
"weatherZone": "CAZ513"
},
"carrier": {
"active": "true",
"fs": "AS",
"iata": "AS",
"icao": "ASA",
"name": "Alaska Airlines",
"phoneNumber": "1-800-252-7522"
},
"delivery": {
"destination": "http://example.com/callback",
"format": "JSON"
},
"departure": "2012-10-23T16:05:00.000",
"departureAirport": {
"active": "true",
"city": "Seattle",
"cityCode": "SEA",
"classification": "1",
"countryCode": "US",
"countryName": "United States",
"delayIndexUrl": "https://api.flightstats.com/flex/delayindex/rest/v1/json/airports/SEA? codeType=fs",
"elevationFeet": "429",
"faa": "SEA",
"fs": "SEA",
"iata": "SEA",
"icao": "KSEA",
"latitude": "47.443839",
"localTime": "2012-10-23T17:58:41.143",
"longitude": "-122.301732",
"name": "Seattle/Tacoma International Airport",
"postalCode": "98158",
"regionName": "North America",
"stateCode": "WA",
"street1": "",
"street2": "",
"timeZoneRegionName": "America/Los_Angeles",
"utcOffsetHours": "-7.0",
"weatherUrl": "https://api.flightstats.com/flex/weather/rest/v1/json/all/SEA?codeType=fs",
"weatherZone": "WAZ001"
},
"flightNumber": "328",
"id": "111709475",
"name": "Default",
"nameValues": null,
"ruleEvents": {
"ruleEvent": {
"type": "ALL_CHANGES"
}
}
}
}
}
