Flight Status Response Element

The flightStatus element is returned for the following request types:

Extended Options
In addition to the standard Extended Options, requests for Flight Status support the following options:
Option Description
includeDeltas Indicates that the optional "flightStatusUpdates" that describe changes to a flight status over time should be included.
Flight Status
Element Cardinality Description
<flightStatus> 0..n Holder element for all status fields related to a flight
<flightId>264915620</flightId> 1..1 The unique identifier for the flight (String).
<carrier> ... </carrier> 0..1 Details for the operating carrier of the flight (if using the extended options to include inlined references, otherwise the airline details will be present in the appendix). Airline Fields
<carrierFsCode>AA</carrierFsCode> 0..1 The FlightStats unique code for the operating carrier to use as a reference for finding the entry in the appendix (unless the extended option to include inlined references is used).
<flightNumber>100</flightNumber> 1..1 The flight identification number and any additional characters (String).
<departureAirport> ... </departureAirport> 0..1 Details for the departure airport (if using the extended options to include inlined references, otherwise the airport details will be present in the appendix). Airport Fields
<departureAirportFsCode>JFK</departureAirportFsCode> 0..1 The FlightStats unique code for the departure airport to use as a reference for finding the entry in the appendix (unless the extended option to include inlined references is used).
<arrivalAirport> ... </arrivalAirport> 0..1 Details for the arrival airport (if using the extended options to include inlined references, otherwise the airport details will be present in the appendix). Airport Fields
<arrivalAirportFsCode>LHR</arrivalAirportFsCode> 0..1 The FlightStats unique code for the arrival airport to use as a reference for finding the entry in the appendix (unless the extended option to include inlined references is used).
<divertedAirport> ... </divertedAirport> 0..1 Details for the airport to which the flight was diverted, if any (if using the extended options to include inlined references, otherwise the airport details will be present in the appendix). Airport Fields
<divertedAirportFsCode>LGW</divertedAirportFsCode> 0..1 The FlightStats unique code for the airport to which the flight was diverted, if any, to use as a reference for finding the entry in the appendix (unless the extended option to include inlined references is used).
<departureDate> 1..1 The departure date of the flight in local and UTC time. This value is likely the publishedDeparture or scheduledGateDeparture value, but could be some other operational value.
<dateLocal>2012-06-05T18:10:00.000</dateLocal> 0..1 The local date and time of the departure in ISO-8601 format. yyyy-MM-dd'T'HH:mm:ss.SSS
<dateUtc>2012-06-05T22:10:00.000Z</dateUtc> 0..1 The UTC date and time of the departure in ISO-8601 format. yyyy-MM-dd'T'HH:mm:ss.SSSZ
</departureDate>
<arrivalDate> 1..1 The arrival date of the flight in local and UTC time. This value is likely the publishedArrival or scheduledGateArrival value, but could be some other operational value.
<dateLocal>2012-06-05T18:10:00.000</dateLocal> 0..1 The local date and time of the arrival in ISO-8601 format. yyyy-MM-dd'T'HH:mm:ss.SSS
<dateUtc>2012-06-05T22:10:00.000Z</dateUtc> 0..1 The UTC date and time of the arrival in ISO-8601 format. yyyy-MM-dd'T'HH:mm:ss.SSSZ
</arrivalDate>
<status>S</status> 1..1 The current status of the flight.
Value Description
A Active
C Canceled
D Diverted
DN Data source needed
L Landed
NO Not Operational
R Redirected
S Scheduled
U Unknown
<schedule> 0..1 Schedule information for the flight.
<flightType>J</flightType> 0..1 The scheduled service type of the flight (IATA).
Value Description
J Scheduled Passenger(Normal Service)
S Scheduled Passenger(Shuttle Service)
U Scheduled Passenger(ServiceVehicle)
F Scheduled Cargo/Mail(Loose loaded cargo and/or preloaded devices)
V ScheduledCargo/Mail(Surface Vehicle)
M Scheduled Cargo/Mail(MailOnly)
Q Scheduled Passenger/Cargo inCabin
G Non-scheduled Passenger(NormalService)
B Non-scheduled Passenger(ShuttleService)
A Non-scheduled Cargo/Mail
C Charter(Passenger Only)
O Charter(Special handling-Migrants/Immigrants)
H Charter(Cargo and/or Mail)
L Charter(Passenger and Cargo and/or Mail)
P Non-revenue
T Technical Test
K Training
D General Aviation
E Special (FAA/Government)
W Military
R Additional Flights - Passenger/Cargo
Y IATA Special Internal(Y)
Z IATA Special Internal(Z)
<serviceClasses>RFJY</serviceClasses> 0..1 IATA service classes offered for the flight. (String)
<restrictions>A</restrictions> 0..1 IATA restrictions imposed on the flight. (String)
<uplines> 0..1 Flights on this route that occur upstream of this one (in order). For example a route that flies from SFO to LAX to JFK to LHR would have SFO and LAX upstream of the JFK to LHR flight.
<upline> 0..n A flight on this route that occurs upstream.
<departureAirport> ... </departureAirport> 0..1 Details for the departure airport of the upline flight (if using the extended options to include inlined references, otherwise the airport details will be present in the appendix). Airport Fields
<fsCode>PDX</fsCode> 0..1 The FlightStats unique code for the departure airport of the upline flight to use as a reference for finding the entry in the appendix (unless the extended option to include inlined references is used).
<flightId>264915620</flightId> 0..1 The unique identifier of the upline flight. This can be used to retrieve detailed status or positions of the upline flight. (String)
</upline>
</uplines>
<downlines> 0..1 Flights on this route that occur downstream of this one (in order). For example a route that flies from SFO to LAX to JFK to LHR would have JFK and LHR downstream of the SFO to LAX flight.
<downline> 0..n A flight on this route that occurs downstream.
<arrivalAirport> ... </arrivalAirport> 0..1 Details for the arrival airport of the downline flight (if using the extended options to include inlined references, otherwise the airport details will be present in the appendix). Airport Fields
<fsCode>HNL</fsCode> 0..1 The FlightStats unique code for the arrival airport of the downline flight to use as a reference for finding the entry in the appendix (unless the extended option to include inlined references is used).
<flightId>264915620</flightId> 0..1 The unique identifier of the downline flight. This can be used to retrieve detailed status or positions of the downline flight. (String)
</downline>
</downlines>
</schedule>
<operationalTimes> 1..1 The operational and scheduled times for the flight.
<publishedDeparture> ... </publishedDeparture> 0..1 The published departure time for the flight provided by the airline's published operating schedule. Time Fields
<publishedArrival> ... </publishedArrival> 0..1 The published arrival time for the flight provided by the airline's published operating schedule. Time Fields
<scheduledGateDeparture> ... </scheduledGateDeparture> 0..1 The scheduled gate departure for the flight. Initially, it's the same as the published departure, but may be updated if a change is detected.Time Fields
<estimatedGateDeparture> ... </estimatedGateDeparture> 0..1 An estimated gate departure time based on current observations. Time Fields
<actualGateDeparture> ... </actualGateDeparture> 0..1 The actual gate departure time observed. Time Fields
<flightPlanPlannedDeparture> ... </flightPlanPlannedDeparture> 0..1 The departure time that was filed with the flight plan. Time Fields
<estimatedRunwayDeparture> ... </estimatedRunwayDeparture> 0..1 An estimated runway departure time based on current observations. Time Fields
<actualRunwayDeparture> ... </actualRunwayDeparture> 0..1 The actual runway departure time observed. Time Fields
<scheduledGateArrival> ... </scheduledGateArrival> 0..1 The scheduled gate arrival time for the flight. Initially, it's the same as the published arrival, but may be updated if a change is detected.Time Fields
<estimatedGateArrival> ... </estimatedGateArrival> 0..1 An estimated gate arrival time based on current observations. Time Fields
<actualGateArrival> ... </actualGateArrival> 0..1 The actual gate arrival time observed. Time Fields
<flightPlanPlannedArrival> ... </flightPlanPlannedArrival> 0..1 The arrival time that was filed with the flight plan.
<estimatedRunwayArrival> ... </estimatedRunwayArrival> 0..1 An estimated runway arrival time based on current observations. Time Fields
<actualRunwayArrival> ... </actualRunwayArrival> 0..1 The actual runway arrival time observed. Time Fields
</operationalTimes>
<codeshares> 0..1 Any codeshare information known for the flight.
<codeshare> 0..n A codeshare for the flight.
<carrier> ... </carrier> 0..1 Details for the codeshare carrier (if using the extended options to include inlined references, otherwise the airline details will be present in the appendix). Airline Fields
<fsCode>AA</fsCode> 1..1 The FlightStats unique code for the codeshare carrier to use as a reference for finding the entry in the appendix (unless the extended option to include inlined references is used).
<flightNumber>6654</flightNumber> 0..1 The codeshare flight identification number and any additional characters (String).
<relationship>L</relationship> 0..1 The codeshare relationship between this carrier and the operating carrier (String).
Value Description
L or Z Commercial duplicate: Flight is sold by one airline, but other airline(s) sell tickets to provide same-carrier connections. Customers will see use the operator's counter and gate at the airport.
S or X Shared airline designator or wet lease: Flight is marketed by one airline and operated by another, but under the name of the marketing carrier. The operating carrier does not sell tickets under their own name.
C Special case of commercial duplicate: a distinct flight number, with the same carrier as the operating carrier.
</codeshare>
</codeshares>
<delays> 0..1 Any calculated delays for the flight based on operational times (scheduled, estimated and actual).
<departureGateDelayMinutes>16 </departureGateDelayMinutes> 0..1 Calculated gate departure delay in whole minutes (Integer).
<departureRunwayDelayMinutes>13 </departureRunwayDelayMinutes> 0..1 Calculated runway departure delay in whole minutes (Integer).
<arrivalGateDelayMinutes>8 </arrivalGateDelayMinutes> 0..1 Calculated gate arrival delay in whole minutes (Integer).
<arrivalRunwayDelayMinutes>7 </arrivalRunwayDelayMinutes> 0..1 Calculated runway arrival delay in whole minutes (Integer).
</delays>
<flightDurations> 0..1 Calculated flight durations based on operational times (scheduled, estimated and actual).
<scheduledBlockMinutes>430 </scheduledBlockMinutes> 0..1 The calculated scheduled time between blocks (scheduled gate to gate) in whole minutes (Integer).
<blockMinutes>425</blockMinutes> 0..1 The calculated time between blocks (actual gate to gate times) in whole minutes (Integer). This will be the actual block time if available.
<scheduledAirMinutes>407 </scheduledAirMinutes> 0..1 The calculated scheduled time in the air (runway to runway) in whole minutes (Integer).
<airMinutes>412</airMinutes> 0..1 The calculated time in the air (runway to runway) in whole minutes (Integer). This will be the actual air time if available, otherwise it will be the current best estimate.
<scheduledTaxiOutMinutes>7 </scheduledTaxiOutMinutes> 0..1 The calculated scheduled time for the plane to taxi out and take off (gate to runway) in whole minutes (Integer).
<taxiOutMinutes>12</taxiOutMinutes> 0..1 The calculated time for the plane to taxi out and take off (gate to runway) in whole minutes (Integer). This will be the actual taxi out time if available, otherwise it will be the current best estimate.
<scheduledTaxiInMinutes>14 </scheduledTaxiInMinutes> 0..1 The calculated scheduled time for the plane to land and taxi in (runway to gate) in whole minutes (Integer).
<taxiInMinutes>13</taxiInMinutes> 0..1 The calculated time for the plane to land and taxi in (runway to gate) in whole minutes (Integer). This will be the actual taxi in time if available, otherwise it will be the current best estimate.
</flightDurations>
<airportResources> 0..1 Information related to the departure and arrival terminal, gate and baggage.
<departureTerminal>8</departureTerminal> 0..1 The terminal from which the flight departed or will depart.
<departureGate>B2</departureGate> 0..1 The gate from which the flight departed or will depart.
<arrivalTerminal>3</arrivalTerminal> 0..1 The terminal into which the flight arrived or will arrive.
<arrivalGate>B2</arrivalGate> 0..1 The gate into which the flight arrived or will arrive.
<baggage>C</baggage> 0..1 The baggage claim information for the arrival.
</airportResources>
<flightEquipment> 0..1 Information about the equipment used for this flight.
<scheduledEquipment> ... </scheduledEquipment> 0..1 The equipment that was scheduled to be flown (if using the extended options to include inlined references, otherwise the equipment details will be present in the appendix). Equipment Fields
<scheduledEquipmentIataCode>777 </scheduledEquipmentIataCode> 0..1 The IATA code for the equipment that was scheduled to be flown to use as a reference for finding the entry in the appendix (unless the extended option to include inlined references is used)
<actualEquipment> ... </actualEquipment> 0..1 The equipment that was actually flown (if using the extended options to include inlined references, otherwise the equipment details will be present in the appendix). Equipment Fields
<actualEquipmentIataCode>777 </actualEquipmentIataCode> 0..1 The IATA code for the equipment that was actually flown to use as a reference for finding the entry in the appendix (unless the extended option to include inlined references is used)
<tailNumber>917F</tailNumber> 0..1 The tail number of the equipment for the flight.
</flightEquipment>
<flightStatusUpdates> 0..1 Contains a list of all updates that have occurred to this flight status since it was originally published.
Optionally included if the extended option "includeDeltas" is used.
<flightStatusUpdate> 0..n A set of changes applied to this status as a result of updated information.
<updatedAt> ... </updatedAt> 1..1 The date and time at which this change was applied (only UTC time is given). Time Fields
<source>Airline Direct</source> 1..1 Textual description of the source of this information (String).
<updatedTextFields> 0..1 A list of text fields that were modified as part of the update.
<updatedTextField> 0..n A single text field updated.
<field>DGT</field> 1..1 The short name of the field that was updated:
Value Description
STS The status of the flight
DGT The departure gate
DTM The departure terminal
AGT The arrival gate
ATM The arrival terminal
DIV The airport for a diversion
BGG The baggage claim information
TAL The tail number of the flight
SQP The scheduled IATA aircraft type code (used to populate the scheduled equipment)
AQP The actual IATA aircraft type code (used to populate the actual equipment)
<originalText>B3</originalText> 0..1 The original field value that was updated. This will be present only if the field original had a value to be replaced.
<newText>B2</newText> 0..1 The new value of the field. If this field is omitted it means that the value was removed as a result of the update.
</updatedTextField>
</updatedTextFields>
<updatedDateFields> 0..1 A list of date fields that were modified as part of the update.
<updatedDateField> 0..n A single date field updated.
<field>SGD</field> 1..1 The short name of the field that was updated:
Value Description
SGD The scheduled gate departure
EGD The estimated gate departure
AGD The actual gate departure
SGA The scheduled gate arrival
EGA The estimated gate arrival
AGA The actual gate arrival
SRD The scheduled runway departure
ERD The estimated runway departure
ARD The actual runway departure
SRA The scheduled runway arrival
ERA The estimated runway arrival
ARA The actual runway arrival
<originalDateLocal>2012-06-05T18:10:00.000</originalDateLocal> 0..1 The local date and time in ISO-8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS). This will be present only if the field original had a value to be replaced.
<newDateLocal>2012-06-05T18:10:00.000</newDateLocal> 0..1 The local date and time in ISO-8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS). If this field is omitted it means that the value was removed as a result of the update.
</updatedDateField>
</updatedDateFields>
</flightStatusUpdate>
</flightStatusUpdates>
<irregularOperations> 0..1 NEW The list of all irregular operations that have occurred for this flight.
<irregularOperation> 0..n NEW An irregular operation that occurred for this flight.
<type>CANCELLATION</type> 1..1 NEW The type of the irregular operation.
Value Description
CANCELLATION Flight has been cancelled for any reason.
CONTINUATION_OF Identifies a linked flight that this flight is a continuation of. Typically a continuation occurs when a flight is diverted to an alternate destination airport in order to get passengers to their scheduled destination.
CONTINUED_BY Identifies a linked flight which will be a continuation of this one. Typically a continuation occurs when a flight is diverted to an alternate destination airport in order to get passengers to their scheduled destination.
DIVERSION Flight is directed to land at a different airport than its scheduled destination.
FLOWN_OVER A fly-over occurs when a plane flying a route comprised of multiple stops skips one or more of the scheduled stops for some reason. The FLOWN_OVER type indicates that the flight in question is not expected to occur because the plane flying the route will not stop at the departure airport specified.
FLYOVER A fly-over occurs when a plane flying a route comprised of multiple stops skips one or more of the scheduled stops for some reason. The FLY_OVER type indicates that the flight in question will not stop at one of the scheduled destinations.
MISCELLANEOUS An irregular operation that does not qualify as one of the other identified types listed here.
REINSTATEMENT A flight was cancelled for a period of time and subsequently reinstated to operational status.
REPLACED_BY Any flight that is cancelled or does not operate for some reason may be replaced by another flight. Provides linking information for the flight that has replaced this one.
REPLACEMENT_FOR Identifies this as a flight that replaced some other flight. Provides linking information for the flight that was replaced by this one.
RETURN_TO_GATE Flight backed away from the gate and started to taxi, does not take off, and returns to gate.
RETURN_FROM_AIRBORNE Flight has taken off and is required to return to its original departure airport.
SUBSEQUENT_OPERATION_BY Identifies the ID of a new flight operation record that is the continuation of the current flight record. For example, a flight with ID 100000000 was diverted, but later continues on to its destination with the ID of 10001010110.
SUBSEQUENT_OPERATION_FOR Identifies the ID of a flight operation that is the origin of the current flight record. For example, a flight with ID 10001010110 was created based on the diversion of the flight with ID 100000000.
<newArrivalAirportFsCode>JFK </newArrivalAirportFsCode> 0..1 NEW FlightStats airport code for the new arrival airport.
<relatedFlightId>12341235</relatedFlightId> 0..1 NEW The unique FlightStats identifier for a flight that is linked to the current flight due to an operational need such as a replacement for a canceled flight.
<dateUtc>2012-06-05T22:10:00.000Z</dateUtc> 0..1 NEW The UTC date and time in ISO-8601 format when this irregular operation information was made available to FlightStats. yyyy-MM-dd'T'HH:mm:ss.SSSZ
<message>Diverted due to airport congestion.</message> 0..1 NEW A message providing a description of this irregular operation as provided by the airline or other data source.
</irregularOperation>
</irregularOperations>
<operatingCarrier> ... </carrier> 0..1 NEW Indicates which carrier is operating the flight - either the primary carrier or a wet lease operator (unless the extended option to include inlined references is used). Airline Fields
<operatingCarrierFsCode>AA</carrierFsCode> 0..1 NEW The FlightStats unique code for the operating carrier to use as a reference for finding the entry in the appendix (unless the extended option to include inlined references is used).
<primaryCarrier> ... </carrier> 0..1 NEW Each flight has one primary carrier. All other carriers associated with a flight are considered either marketing codeshare carriers or a wet lease operator. The FlightStats unique code for the primary carrier can be used as a reference for finding the entry in the appendix (unless the extended option to include inlined references is used). Airline Fields
<primaryCarrierFsCode>AA</carrierFsCode> 0..1 NEW The FlightStats unique code for the primary carrier to use as a reference for finding the entry in the appendix (unless the extended option to include inlined references is used).
<confirmedIncident> 0..1 NEW A confirmed incident for this flight.
<publishedDate>2012-06-05T22:10:00.000Z</publishedDate> 1..1 NEW The date of the confirmed incident or the date of the last update to the confirmed incident.
<message>The plane has slid off the runway</message> 1..1 NEW A text description of the incident.
</confirmedIncident>
</flightStatus>
Times
Element Cardinality Description
<dateLocal>2012-06-05T18:10:00.000</dateLocal> 0..1 The local date and time in ISO-8601 format. yyyy-MM-dd'T'HH:mm:ss.SSS
<dateUtc>2012-06-05T22:10:00.000Z</dateUtc> 0..1 The UTC date and time in ISO-8601 format. yyyy-MM-dd'T'HH:mm:ss.SSSZ
Airline
Element Cardinality Description
<fs>AA<fs> 1..1 The FlightStats code for the carrier, globally unique across time (String).
<iata>AA<iata> 0..1 The IATA code for the carrier (String).
<icao>AAL<icao> 0..1 The ICAO code for the carrier (String).
<name>American Airlines<name> 1..1 The name of the carrier (String).
<phoneNumber>1-800-433-7300</phoneNumber> 0..1 The primary customer service phone number for the carrier (String).
<active>true</active> 1..1 Boolean value indicating if the airline is currently active (Boolean).
<category>A</category> 0..1 NEW The category of operation of the airline:
Value Description Passenger Cargo
A Scheduled Passenger Carrier Y N
B Non-Scheduled Passenger Carrier Y N
C Scheduled Cargo Carrier N Y
D Non-scheduled Cargo Carrier N Y
I Scheduled Passenger/Cargo Carrier Y Y
J Non-scheduled Passenger/Cargo Carrier Y Y
K Railway Service Y Y
Fields marked as NEW will only be returned if the extended option "includeNewFields" is used. See the Flex API Version Policy page for details.
Airport
Element Cardinality Description
<fs>PDX</fs> 1..1 The FlightStats code for the airport, globally unique across time (String).
<iata>PDX</iata> 0..1 The IATA code for the airport (String).
<icao>KPDX</icao> 0..1 The ICAO code for the airport (String).
<faa>PDX</faa> 0..1 The FAA code for the airport (String).
<name>Portland International Airport</name> 0..1 The name of the airport (String).
<street1>7000 Northeast, Airport Way</street1> 0..1 The street address of the airport, part 1 (String).
<street2></street2> 0..1 Street address of the airport, part 2 (String).
<city>Portland</city> 1..1 The city with which the airport is associated (String).
<cityCode>PDX</cityCode> 0..1 The city code with which the airport is associated (String).
<district>Chaoyang</district> 0..1 NEW The district of the city in which the airport is located (String).
<stateCode>OR</stateCode> 0..1 The State in which the airport is located (String).
<postalCode>97216</postalCode> 0..1 The postal code in which the airport resides (String).
<countryCode>US</countryCode> 1..1 The code for the country in which the airport is located (String).
<countryName>United States</countryName> 1..1 The name of the country in which the Airport is located (String).
<regionName>North America</regionName> 1..1 The name of the region in which the Airport is located (String).
<timeZoneRegionName>America/Los_Angeles</timeZoneRegionName> 1..1 The name of the Time Zone region in which the Airport is located (String).
<weatherZone>ORZ006</weatherZone> 0..1 The NOAA weather zone (US only) in which the Airport is located (String).
<localTime>2012-08-09T11:02:59.571</localTime> 1..1 The local time at the Airport when the request was made in ISO-8601 format. yyyy-MM-dd'T'HH:mm:ss.SSS.
<utcOffsetHours>-7.0</utcOffsetHours> 1..1 The current UTC offset at the Airport when the request was made (Double).
<latitude>40.642335</latitude> 1..1 The latitude of the airport in decimal degrees (Double).
<longitude>-73.78817</longitude> 1..1 The longitude of the airport in decimal degrees (Double).
<elevationFeet>30</elevationFeet> 1..1 The elevation above sea level of the airport in feet (Integer).
<classification>1</classification> 1..1 The FlightStats classification of the airport, 1(max) to 5(min). (Integer).
<active>true</active> 1..1 Boolean value indicating if the airport is currently operational (Boolean).
<delayIndexUrl>https://api.flightstats.com/flex/delayindex/rest/v1/json/airports/PDX?codeType=fs</delayIndexUrl> 1..1 URL for the DelayIndex service with current delay information computed for the Airport (String).
<weatherUrl>https://api.flightstats.com/flex/weather/rest/v1/json/all/PDX?codeType=fs</weatherUrl> 1..1 URL for the Weather service with current weather data for the Airport (String).
Fields marked as NEW will only be returned if the extended option "includeNewFields" is used. See the Flex API Version Policy page for details.
Equipment
Element Cardinality Description
<iata>777</iata> 1..1 The IATA code for the equipment type. (String)
<name>Boeing 777 Passenger</name> 1..1 The descriptive name for the equipment type. (String)
<turboProp>false</turboProp> 1..1 Boolean value indicating if the equipment type uses TurboProp propulsion (Boolean).
<jet>true</jet> 1..1 Boolean value indicating if the equipment type uses jet propulsion (Boolean).
<widebody>true</widebody> 1..1 Boolean value indicating if the equipment type is a wide-body airframe (Boolean).
<regional>false</regional> 1..1 Boolean value indicating if the equipment type is a regional airframe (Boolean).
Example XML Output
The following example is a partial response and uses inline references for simplicity.
See Full Sample Responses for a complete response.
<flightStatus> <flightId>271046927</flightId> <carrier> <fs>AA</fs> <iata>AA</iata> <icao>AAL</icao> <name>American Airlines</name> <phoneNumber>1-800-433-7300</phoneNumber> <active>true</active> </carrier> <flightNumber>100</flightNumber> <departureAirport> <fs>JFK</fs> <iata>JFK</iata> <icao>KJFK</icao> <faa>JFK</faa> <name>John F. Kennedy International Airport</name> <street1>JFK Airport</street1> <street2/> <city>New York</city> <cityCode>NYC</cityCode> <stateCode>NY</stateCode> <postalCode>11430</postalCode> <countryCode>US</countryCode> <countryName>United States</countryName> <regionName>North America</regionName> <timeZoneRegionName>America/New_York</timeZoneRegionName> <weatherZone>NYZ076</weatherZone> <localTime>2012-08-09T14:49:12.368</localTime> <utcOffsetHours>-4.0</utcOffsetHours> <latitude>40.642335</latitude> <longitude>-73.78817</longitude> <elevationFeet>13</elevationFeet> <classification>1</classification> <active>true</active> <delayIndexUrl>https://api.flightstats.com/flex/delayindex/rest/v1/json/airports/JFK?codeType=fs</delayIndexUrl> <weatherUrl>https://api.flightstats.com/flex/weather/rest/v1/json/all/JFK?codeType=fs</weatherUrl> </departureAirport> <arrivalAirport> <fs>LHR</fs> <iata>LHR</iata> <icao>EGLL</icao> <name>Heathrow Airport</name> <city>London</city> <cityCode>LON</cityCode> <stateCode>EN</stateCode> <countryCode>GB</countryCode> <countryName>United Kingdom</countryName> <regionName>Europe</regionName> <timeZoneRegionName>Europe/London</timeZoneRegionName> <localTime>2012-08-09T19:49:12.368</localTime> <utcOffsetHours>1.0</utcOffsetHours> <latitude>51.469603</latitude> <longitude>-0.453566</longitude> <elevationFeet>80</elevationFeet> <classification>1</classification> <active>true</active> <delayIndexUrl>https://api.flightstats.com/flex/delayindex/rest/v1/json/airports/LHR?codeType=fs</delayIndexUrl> <weatherUrl>https://api.flightstats.com/flex/weather/rest/v1/json/all/LHR?codeType=fs</weatherUrl> </arrivalAirport> <departureDate> <dateLocal>2012-08-07T18:10:00.000</dateLocal> <dateUtc>2012-08-07T22:10:00.000Z</dateUtc> </departureDate> <arrivalDate> <dateLocal>2012-08-08T06:20:00.000</dateLocal> <dateUtc>2012-08-08T05:20:00.000Z</dateUtc> </arrivalDate> <status>L</status> <schedule> <flightType>J</flightType> <serviceClasses>RFJY</serviceClasses> <restrictions/> </schedule> <operationalTimes> <publishedDeparture> <dateLocal>2012-08-07T18:10:00.000</dateLocal> <dateUtc>2012-08-07T22:10:00.000Z</dateUtc> </publishedDeparture> <publishedArrival> <dateLocal>2012-08-08T06:20:00.000</dateLocal> <dateUtc>2012-08-08T05:20:00.000Z</dateUtc> </publishedArrival> <scheduledGateDeparture> <dateLocal>2012-08-07T18:10:00.000</dateLocal> <dateUtc>2012-08-07T22:10:00.000Z</dateUtc> </scheduledGateDeparture> <actualGateDeparture> <dateLocal>2012-08-07T18:05:00.000</dateLocal> <dateUtc>2012-08-07T22:05:00.000Z</dateUtc> </actualGateDeparture> <flightPlanPlannedDeparture> <dateLocal>2012-08-07T18:54:00.000</dateLocal> <dateUtc>2012-08-07T22:54:00.000Z</dateUtc> </flightPlanPlannedDeparture> <estimatedRunwayDeparture> <dateLocal>2012-08-07T18:49:00.000</dateLocal> <dateUtc>2012-08-07T22:49:00.000Z</dateUtc> </estimatedRunwayDeparture> <actualRunwayDeparture> <dateLocal>2012-08-07T18:23:00.000</dateLocal> <dateUtc>2012-08-07T22:23:00.000Z</dateUtc> </actualRunwayDeparture> <scheduledGateArrival> <dateLocal>2012-08-08T06:20:00.000</dateLocal> <dateUtc>2012-08-08T05:20:00.000Z</dateUtc> </scheduledGateArrival> <estimatedGateArrival> <dateLocal>2012-08-08T06:07:00.000</dateLocal> <dateUtc>2012-08-08T05:07:00.000Z</dateUtc> </estimatedGateArrival> <actualGateArrival> <dateLocal>2012-08-08T06:09:00.000</dateLocal> <dateUtc>2012-08-08T05:09:00.000Z</dateUtc> </actualGateArrival> <flightPlanPlannedArrival> <dateLocal>2012-08-08T06:14:00.000</dateLocal> <dateUtc>2012-08-08T05:14:00.000Z</dateUtc> </flightPlanPlannedArrival> <estimatedRunwayArrival> <dateLocal>2012-08-08T06:07:00.000</dateLocal> <dateUtc>2012-08-08T05:07:00.000Z</dateUtc> </estimatedRunwayArrival> <actualRunwayArrival> <dateLocal>2012-08-08T06:05:00.000</dateLocal> <dateUtc>2012-08-08T05:05:00.000Z</dateUtc> </actualRunwayArrival> </operationalTimes> <codeshares> <codeshare> <carrier> <fs>LY</fs> <iata>LY</iata> <icao>ELY</icao> <name>El Al</name> <active>true</active> </carrier> <flightNumber>8051</flightNumber> <relationship>L</relationship> </codeshare> <codeshare> <carrier> <fs>IB</fs> <iata>IB</iata> <icao>IBE</icao> <name>Iberia</name> <active>true</active> </carrier> <flightNumber>4218</flightNumber> <relationship>L</relationship> </codeshare> <codeshare> <carrier> <fs>BA</fs> <iata>BA</iata> <icao>BAW</icao> <name>British Airways</name> <phoneNumber>1-800-AIRWAYS</phoneNumber> <active>true</active> </carrier> <flightNumber>1511</flightNumber> <relationship>L</relationship> </codeshare> <codeshare> <carrier> <fs>GF</fs> <iata>GF</iata> <icao>GFA</icao> <name>Gulf Air</name> <active>true</active> </carrier> <flightNumber>6654</flightNumber> <relationship>L</relationship> </codeshare> </codeshares> <flightDurations> <scheduledBlockMinutes>430</scheduledBlockMinutes> <blockMinutes>424</blockMinutes> <scheduledAirMinutes>380</scheduledAirMinutes> <airMinutes>402</airMinutes> <scheduledTaxiOutMinutes>44</scheduledTaxiOutMinutes> <taxiOutMinutes>18</taxiOutMinutes> <scheduledTaxiInMinutes>6</scheduledTaxiInMinutes> <taxiInMinutes>4</taxiInMinutes> </flightDurations> <airportResources> <departureTerminal>8</departureTerminal> <departureGate>B3</departureGate> <arrivalTerminal>3</arrivalTerminal> <arrivalGate>36</arrivalGate> </airportResources> <flightEquipment> <scheduledEquipment> <iata>777</iata> <name>Boeing 777 Passenger</name> <turboProp>false</turboProp> <jet>true</jet> <widebody>true</widebody> <regional>false</regional> </scheduledEquipment> <tailNumber>N753AN</tailNumber> </flightEquipment> <irregularOperations> <irregularOperation> <type>CANCELLATION</type> <dateUtc>2013-02-26T23:00:00.000Z</dateUtc> <message>Cancelled due to mechanical issue.</message> </irregularOperation> <irregularOperation> <type>REPLACED_BY</type> <relatedFlightId>24586521</relatedFlightId> <dateUtc>2013-02-26T23:00:00.000Z</dateUtc> <message>New flight created to replace a cancelled flight.</message> </irregularOperation> </irregularOperations> <confirmedIncident> <publishedDate>2013-02-26T23:00:00.000Z</publishedDate> <message>The plane has slid off the runway.</message> </confirmedIncident> <operatingCarrier> <fs>AA</fs> <iata>AA</iata> <icao>AAL</icao> <name>American Airlines</name> <phoneNumber>1-800-433-7300</phoneNumber> <active>true</active> </operatingCarrier> <primaryCarrier> <fs>AA</fs> <iata>AA</iata> <icao>AAL</icao> <name>American Airlines</name> <phoneNumber>1-800-433-7300</phoneNumber> <active>true</active> </primaryCarrier> </flightStatus>
Example JSON Output (whitespace added for clarity)
The following example is a partial response and uses inline references for simplicity.
See Full Sample Responses for a complete response.
{ flightStatus: { flightId: 271046927, carrier: { fs: "AA", iata: "AA", icao: "AAL", name: "American Airlines", phoneNumber: "1-800-433-7300", active: true }, flightNumber: "100", departureAirport: { fs: "JFK", iata: "JFK", icao: "KJFK", faa: "JFK", name: "John F. Kennedy International Airport", street1: "JFK Airport", street2: "", city: "New York", cityCode: "NYC", stateCode: "NY", postalCode: "11430", countryCode: "US", countryName: "United States", regionName: "North America", timeZoneRegionName: "America/New_York", weatherZone: "NYZ076", localTime: "2012-08-09T14:47:31.438", utcOffsetHours: -4, latitude: 40.642335, longitude: -73.78817, elevationFeet: 13, classification: 1, active: true, delayIndexUrl: "https://api.flightstats.com/flex/delayindex/rest/v1/json/airports/JFK?codeType=fs", weatherUrl: "https://api.flightstats.com/flex/weather/rest/v1/json/all/JFK?codeType=fs" }, arrivalAirport: { fs: "LHR", iata: "LHR", icao: "EGLL", name: "Heathrow Airport", city: "London", cityCode: "LON", stateCode: "EN", countryCode: "GB", countryName: "United Kingdom", regionName: "Europe", timeZoneRegionName: "Europe/London", localTime: "2012-08-09T19:47:31.439", utcOffsetHours: 1, latitude: 51.469603, longitude: -0.453566, elevationFeet: 80, classification: 1, active: true, delayIndexUrl: "https://api.flightstats.com/flex/delayindex/rest/v1/json/airports/LHR?codeType=fs", weatherUrl: "https://api.flightstats.com/flex/weather/rest/v1/json/all/LHR?codeType=fs" }, departureDate: { dateLocal: "2012-08-07T18:10:00.000", dateUtc: "2012-08-07T22:10:00.000Z" }, arrivalDate: { dateLocal: "2012-08-08T06:20:00.000", dateUtc: "2012-08-08T05:20:00.000Z" }, status: "L", schedule: { flightType: "J", serviceClasses: "RFJY", restrictions: "" }, operationalTimes: { publishedDeparture: { dateLocal: "2012-08-07T18:10:00.000", dateUtc: "2012-08-07T22:10:00.000Z" }, publishedArrival: { dateLocal: "2012-08-08T06:20:00.000", dateUtc: "2012-08-08T05:20:00.000Z" }, scheduledGateDeparture: { dateLocal: "2012-08-07T18:10:00.000", dateUtc: "2012-08-07T22:10:00.000Z" }, actualGateDeparture: { dateLocal: "2012-08-07T18:05:00.000", dateUtc: "2012-08-07T22:05:00.000Z" }, flightPlanPlannedDeparture: { dateLocal: "2012-08-07T18:54:00.000", dateUtc: "2012-08-07T22:54:00.000Z" }, estimatedRunwayDeparture: { dateLocal: "2012-08-07T18:49:00.000", dateUtc: "2012-08-07T22:49:00.000Z" }, actualRunwayDeparture: { dateLocal: "2012-08-07T18:23:00.000", dateUtc: "2012-08-07T22:23:00.000Z" }, scheduledGateArrival: { dateLocal: "2012-08-08T06:20:00.000", dateUtc: "2012-08-08T05:20:00.000Z" }, estimatedGateArrival: { dateLocal: "2012-08-08T06:07:00.000", dateUtc: "2012-08-08T05:07:00.000Z" }, actualGateArrival: { dateLocal: "2012-08-08T06:09:00.000", dateUtc: "2012-08-08T05:09:00.000Z" }, flightPlanPlannedArrival: { dateLocal: "2012-08-08T06:14:00.000", dateUtc: "2012-08-08T05:14:00.000Z" }, estimatedRunwayArrival: { dateLocal: "2012-08-08T06:07:00.000", dateUtc: "2012-08-08T05:07:00.000Z" }, actualRunwayArrival: { dateLocal: "2012-08-08T06:05:00.000", dateUtc: "2012-08-08T05:05:00.000Z" } }, codeshares: [ { carrier: { fs: "LY", iata: "LY", icao: "ELY", name: "El Al", active: true }, flightNumber: "8051", relationship: "L" }, { carrier: { fs: "IB", iata: "IB", icao: "IBE", name: "Iberia", active: true }, flightNumber: "4218", relationship: "L" }, { carrier: { fs: "BA", iata: "BA", icao: "BAW", name: "British Airways", phoneNumber: "1-800-AIRWAYS", active: true }, flightNumber: "1511", relationship: "L" }, { carrier: { fs: "GF", iata: "GF", icao: "GFA", name: "Gulf Air", active: true }, flightNumber: "6654", relationship: "L" } ], flightDurations: { scheduledBlockMinutes: 430, blockMinutes: 424, scheduledAirMinutes: 380, airMinutes: 402, scheduledTaxiOutMinutes: 44, taxiOutMinutes: 18, scheduledTaxiInMinutes: 6, taxiInMinutes: 4 }, airportResources: { departureTerminal: "8", departureGate: "B3", arrivalTerminal: "3", arrivalGate: "36" }, flightEquipment: { scheduledEquipment: { iata: "777", name: "Boeing 777 Passenger", turboProp: false, jet: true, widebody: true, regional: false }, tailNumber: "N753AN" }, irregularOperations: [ { type: "CANCELLATION", dateUtc: "2013-02-26T23:00:00.000Z", message: "Cancelled due to mechanical issue." }, { type: "REPLACED_BY", relatedFlightId: 24586521, dateUtc: "2013-02-26T23:00:00.000Z", message: "New flight created to replace a cancelled flight." } ], confirmedIncident: { publishedDate: "2013-02-26T23:00:00.000Z", message: "The plan has slid off the runway." }, operatingCarrier: { fs: "AA", iata: "AA", icao: "AAL", name: "American Airlines", phoneNumber: "1-800-433-7300", active: true }, primaryCarrier: { fs: "AA", iata: "AA", icao: "AAL", name: "American Airlines", phoneNumber: "1-800-433-7300", active: true }}
Full Sample Responses