Connections Response element

The Connections Response Element is returned for the following request type:

Connection
Element Cardinality Description
<connections> 0..n Holder element for all returned connections
<connection> 0..n Holder element for a connection
<elapsedTime>90303M</elapsedTime> 1..1 The total time in minutes from the original departure to the final arrival
<score>90303</score> 1..1 A heuristic scoring of the connection, based on factors such as travel time, total connecting flights, and closeness to desired departure/arrival time
<scheduledFlights>...</scheduledFlights> 1..1 Holder element for the flights that compose the overall connection
</connection> 0..n
</connections>
Scheduled Flight
Element Cardinality Description
<carrierFsCode>AA</carrierFsCode> 0..1 The Cirium 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).
<departureAirportFsCode>JFK</departureAirportFsCode> 0..1 The Cirium 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).
<arrivalAirportFsCode>LHR</arrivalAirportFsCode> 0..1 The Cirium 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).
<stops>0<stops> 1..1 The number of stops between the departure and arrival airport. This will always be 0 unless the extended option "includeDirects" is specified.
<departureTerminal>8</departureTerminal> 0..1 The terminal from which the flight departed or will depart.
<arrivalTerminal>3</arrivalTerminal> 0..1 The terminal into which the flight arrived or will arrive.
<departureTime>2013-05-21T18:05:00.000</departureTime> 1..1 The published departure time (local to the airport) for the flight provided by the airline's operating schedule.
<arrivalTime>2013-05-22T06:20:00.000</arrivalTime> 1..1 The published arrival time (local to the airport) for the flight provided by the airline's operating schedule.
<flightEquipmentIataCode>777</flightEquipmentIataCode> 0..n The IATA code for the equipment 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)
<isCodeshare>false</isCodeshare> 1..1 Boolean value indicating if the marketed flight is a codeshare.
<isWetlease>false</isWetlease> 1..1 Boolean value indicating if the marketed flight is a wetlease.
<serviceType>J</serviceType> 1..1 The type of service offered for the flight:
Value Description Passenger Cargo Surface
J Scheduled Passenger (Normal Service) Y N N
S Scheduled Passenger (Shuttle Service) Y N N
G Non-scheduled Passenger (Normal Service) Y N N
B Non-scheduled Passenger (Shuttle Service) Y N N
C Charter (Passenger Only) Y N N
O Charter (Special handling - Migrants/Immigrants) Y N N
L Charter (Passenger and Cargo and/or Mail) Y Y N
R Additional Flights - Passenger/Cargo Y Y N
Q Scheduled Passenger/Cargo in Cabin Y Y N
F Scheduled Cargo/Mail (Loose loaded cargo and/or preloaded devices) N Y N
M Scheduled Cargo/Mail (Mail Only) N Y N
A Non-scheduled Cargo/Mail N Y N
H Charter (Cargo and/or Mail) N Y N
V Scheduled Cargo/Mail (Surface Vehicle) N Y Y
U Scheduled Passenger (Service Vehicle) Y N Y
<serviceClasses> 0..1 IATA service classes offered for the flight.
<serviceClass>R</serviceClass> 1..n IATA service class offered for the flight.
</serviceClasses>
<trafficRestrictions> 0..1 IATA restrictions imposed on the flight.
<trafficRestriction>Q</trafficRestriction> 1..n IATA restriction imposed on the flight. (One-letter string)
</trafficRestrictions>
<codeshares> 0..1 Any codeshares for this operated flight. Codeshares are only possible if this flight leg is not itself a codeshare (the codeshare field must be false).
<codeshare> 1..n codeshare for this operated flight.
<carrierFsCode>LY</carrierFsCode> 0..1 The Cirium unique code for the carrier that is marketing the codeshare (this may be the operator or a codeshare partner) to use as a reference for finding the entry in the appendix (unless the extended option 'useInlinedReferences' is used).
<flightNumber>8051</flightNumber> 1..1 The flight number marketed by the codeshare partner.
<serviceType>J</serviceType> 0..n The type of service offered for the flight (see serviceType above).
<serviceClasses> 0..n IATA service classes offered for the flight.
<serviceClass>F</serviceClass> 1..n IATA service class offered for the flight.
</serviceClasses>
<trafficRestrictions> 0..1 IATA restrictions imposed on the flight.
<trafficRestriction>Q</trafficRestriction> 1..n IATA restriction imposed on the flight. (One-letter string)
</trafficRestrictions>
</codeshare>
</codeshares>
<wetleaseOperatorFsCode>8051</wetleaseOperatorFsCode> 1..1 The FS code of the wetlease operator.
<elapsedTime>90303</elapsedTime> 1..1 The total time in minutes from the departure to arrival for this specific flight
Airline
Element Cardinality Description
<fs>AA<fs> 1..1 The Cirium 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
E Railway Company Y Y
F Ferry Company N Y
G Non-airline ULD N Y
H Computer Reservation System n/a n/a
I Scheduled Passenger/Cargo Carrier Y Y
J Non-scheduled Passenger/Cargo Carrier Y Y
K Bus Company Y Y
S Miscellaneous/Other n/a n/a
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 Cirium 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 Cirium 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).
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 JSON Output (whitespace added for clarity)
{ "request": { "endpoint": "LastFlightIn", "departure": { "requested": "PDX", "interpreted": "PDX" }, "arrival": { "requested": "YYZ", "interpreted": "YYZ" }, "includeAirports": { "interpreted": [] }, "excludeAirports": { "interpreted": [] }, "includeAirlines": { "interpreted": [] }, "excludeAirlines": { "interpreted": [] }, "numHours": { "requested": "16", "interpreted": 16 }, "maxConnections": { "requested": "3", "interpreted": 3 }, "includeSurface": { "requested": "false", "interpreted": false }, "payloadType": { "requested": "all", "interpreted": "all" }, "includeCodeshares": { "requested": "true", "interpreted": true }, "includeMultipleCarriers": { "requested": "true", "interpreted": true }, "maxResults": { "requested": "25", "interpreted": 25 }, "url": "https://api.flightstats.com/flex/connections/rest/v2/json/lastflightin/PDX/to/YYZ/arriving_before/2020/8/24/23/1?includeCodeshares=true&payloadType=all&maxResults=25&includeMultipleCarriers=true&numHours=16&includeSurface=false&maxConnections=3", "dateTime": { "year": "2020", "month": "8", "day": "24", "hour": "23", "minute": "1", "interpreted": "2020-08-24T23:01" } }, "connections": [ { "elapsedTime": 1509, "score": 118200, "scheduledFlight": [ { "carrierFsCode": "DL", "flightNumber": "4714", "departureAirportFsCode": "PDX", "arrivalAirportFsCode": "PHL", "stops": 0, "departureTerminal": "EM", "arrivalTerminal": "D", "departureTime": "2020-08-22T12:30:00.000", "arrivalTime": "2020-08-22T14:11:00.000", "flightEquipmentIataCode": "CR9", "isCodeshare": true, "isWetlease": true, "serviceType": "V", "serviceClasses": [ "J", "Y" ], "trafficRestrictions": [], "codeshares": [ { "carrierFsCode": "KE", "flightNumber": "3237", "serviceType": "V", "trafficRestrictions": [] }, { "carrierFsCode": "WS", "flightNumber": "6777", "serviceType": "V", "trafficRestrictions": [] } ], "elapsedTime": 101 }, { "carrierFsCode": "DL", "flightNumber": "1705", "departureAirportFsCode": "PHL", "arrivalAirportFsCode": "LAX", "stops": 0, "departureTime": "2020-08-22T15:55:00.000", "arrivalTime": "2020-08-22T18:02:00.000", "flightEquipmentIataCode": "319", "isCodeshare": false, "isWetlease": false, "serviceType": "V", "serviceClasses": [ "J", "Y", "O", "R" ], "trafficRestrictions": [], "elapsedTime": 187 }, { "carrierFsCode": "DL", "flightNumber": "3085", "departureAirportFsCode": "LAX", "arrivalAirportFsCode": "LGA", "stops": 0, "arrivalTerminal": "D", "departureTime": "2020-08-23T06:10:00.000", "arrivalTime": "2020-08-23T10:13:00.000", "flightEquipmentIataCode": "221", "isCodeshare": false, "isWetlease": false, "serviceType": "J", "serviceClasses": [ "J", "Y" ], "trafficRestrictions": [], "codeshares": [ { "carrierFsCode": "WS", "flightNumber": "6721", "serviceType": "J", "trafficRestrictions": [] } ], "elapsedTime": 183 }, { "carrierFsCode": "DL", "flightNumber": "1207", "departureAirportFsCode": "LGA", "arrivalAirportFsCode": "YYZ", "stops": 0, "departureTerminal": "C", "arrivalTerminal": "3", "departureTime": "2020-08-23T12:00:00.000", "arrivalTime": "2020-08-23T13:39:00.000", "flightEquipmentIataCode": "73W", "isCodeshare": false, "isWetlease": false, "serviceType": "J", "serviceClasses": [ "F", "Y", "O", "R" ], "trafficRestrictions": [], "codeshares": [ { "carrierFsCode": "DL", "flightNumber": "7141", "serviceType": "J", "trafficRestrictions": [] } ], "elapsedTime": 91 } ] } ], "appendix": { "airlines": [ { "fs": "DL", "iata": "DL", "icao": "DAL", "name": "Delta Air Lines", "active": true, "category": "I" }, { "fs": "KE", "iata": "KE", "icao": "KAL", "name": "Korean Air", "active": true, "category": "I" }, { "fs": "WS", "iata": "WS", "icao": "WJA", "name": "WestJet", "active": true, "category": "I" } ], "airports": [ { "fs": "LAX", "iata": "LAX", "icao": "KLAX", "faa": "LAX", "name": "Los Angeles International Airport", "street1": "One World Way", "street2": "", "city": "Los Angeles", "cityCode": "LAX", "stateCode": "CA", "postalCode": "90045-5803", "countryCode": "US", "countryName": "United States", "regionName": "North America", "timeZoneRegionName": "America/Los_Angeles", "weatherZone": "CAZ041", "localTime": "2020-08-31T11:47:42.535", "utcOffsetHours": -7.0, "latitude": 33.943399, "longitude": -118.408279, "elevationFeet": 126, "classification": 1, "active": true }, { "fs": "PHL", "iata": "PHL", "icao": "KPHL", "faa": "PHL", "name": "Philadelphia International Airport", "street1": "Industrial Highway and Island Road", "city": "Philadelphia", "cityCode": "PHL", "stateCode": "PA", "postalCode": "19153", "countryCode": "US", "countryName": "United States", "regionName": "North America", "timeZoneRegionName": "America/New_York", "weatherZone": "PAZ071", "localTime": "2020-08-31T14:47:42.535", "utcOffsetHours": -4.0, "latitude": 39.876413, "longitude": -75.243305, "elevationFeet": 10, "classification": 1, "active": true }, { "fs": "PDX", "iata": "PDX", "icao": "KPDX", "faa": "PDX", "name": "Portland International Airport", "street1": "7000 NE Airport Way", "city": "Portland", "cityCode": "PDX", "stateCode": "OR", "postalCode": "97218", "countryCode": "US", "countryName": "United States", "regionName": "North America", "timeZoneRegionName": "America/Los_Angeles", "weatherZone": "ORZ006", "localTime": "2020-08-31T11:47:42.535", "utcOffsetHours": -7.0, "latitude": 45.588995, "longitude": -122.592901, "elevationFeet": 30, "classification": 1, "active": true }, { "fs": "LGA", "iata": "LGA", "icao": "KLGA", "faa": "LGA", "name": "LaGuardia Airport", "street1": "Hangar 7 Center", "city": "New York", "cityCode": "NYC", "stateCode": "NY", "postalCode": "11371", "countryCode": "US", "countryName": "United States", "regionName": "North America", "timeZoneRegionName": "America/New_York", "weatherZone": "NYZ176", "localTime": "2020-08-31T14:47:42.536", "utcOffsetHours": -4.0, "latitude": 40.774252, "longitude": -73.871617, "elevationFeet": 22, "classification": 1, "active": true }, { "fs": "YYZ", "iata": "YYZ", "icao": "CYYZ", "faa": "", "name": "Pearson International Airport", "street1": "", "street2": "", "city": "Toronto", "cityCode": "YTO", "stateCode": "ON", "postalCode": "L5P 1B2", "countryCode": "CA", "countryName": "Canada", "regionName": "North America", "timeZoneRegionName": "America/Toronto", "weatherZone": "", "localTime": "2020-08-31T14:47:42.536", "utcOffsetHours": -4.0, "latitude": 43.681585, "longitude": -79.61146, "elevationFeet": 569, "classification": 1, "active": true } ], "equipments": [ { "iata": "221", "name": "Airbus A220-100 Passenger", "turboProp": false, "jet": true, "widebody": false, "regional": false }, { "iata": "CR9", "name": "Canadair (Bombardier) Regional Jet 900 and Challenger 890", "turboProp": false, "jet": true, "widebody": false, "regional": true }, { "iata": "319", "name": "Airbus A319", "turboProp": false, "jet": true, "widebody": false, "regional": false }, { "iata": "73W", "name": "Boeing 737-700 (winglets) Passenger/BBJ1", "turboProp": false, "jet": true, "widebody": false, "regional": false } ] } }