FIDS Data Response Element

The FIDS Data element is returned for the following request:

The FIDS (Flight Information Display System) API provides a customizable set of data pertaining to flights for a particular airport.

A FIDS request produces an XML or JSON response with a flat structure that contains only those fields chosen by the requestedFields query parameter. These are the available fields:

Field Description Example
flightId Numeric flight ID. This can be used to look up more detailed flight information via the Flight Status by Flight API. 430791
lastUpdatedTime Time of day that this flight information was last updated, according to the selected airport's timezone. 11:47
lastUpdatedTimeUtc Time of day that this flight information was last updated, in UTC. 04:47
lastUpdatedDate Date that this flight information was last updated, according to the selected airport's timezone. 01/30/2013
lastUpdatedDateUtc Date that this flight information was last updated, in UTC. 01/31/2013
dayOffset Nonnegative integer representing the number of days forward from today (according to the selected airport's time zone). For today's flights, this will be 0. 0
statusCode Single-character Cirium code for the status of the flight A
airlineName Name of the airline. For wet leases, this will be the marketing airline rather than the operating airline. British Airways
airlineCode Airline code of the airline. For wet leases, this will be the code for the marketing airline rather than the operating airline. BA
flightNumber Flight number assigned by the airline. 100
airlineLogoUrlPng URL of the airline logo as a 300x100 PNG image. Logo is for the operating airline, or in the case of a wet lease, the marketing airline. (The logos are provided As Is. Some may be out-of-date or missing.) http://d3brl4nqahsb3e.cloudfront.net/logos/png/300x100/ba-logo.png
airlineLogoUrlSvg URL of the airline logo as an SVG image. Logo is for the operating airline, or in the case of a wet lease, the marketing airline. (The logos are provided As Is. Some may be out-of-date or missing.) http://d3brl4nqahsb3e.cloudfront.net/logos/svg/ba-logo.svg
isCodeshare Boolean value indicating whether the flight is a codeshare (flight marketed by multiple airlines). true
operatedFlightNumber Flight number assigned by the operating airline. 200
operatingAirlineName Name of the operating airline. British Airways
operatingAirlineCode Code of the operating airline. BA
originCity Name of the flight's origin city. Dallas
originAirportName Name of the flight's origin airport. Newark Liberty International Airport
originAirportCode Code of the flight's origin airport. LAX
originFamiliarName A name for the flight origin that the travelers expect, particularly used to distinguish between cities with the same name or multiple airports that serve the same city. New York - JFK
originStateCode State (or province, where applicable) code of the origin airport. WA
originCountryCode Country code of the flight's origin airport. UK
destinationAirportName Name of the flight's destination airport. Portland International Airport
destinationAirportCode Code of the flight's destination airport. PDX
destinationCity Name of the flight's destination city. Portland
destinationFamiliarName A name for the destination that the travelers expect, particularly used to distinguish between cities with the same name or multiple airports that serve the same city. New York - JFK
destinationStateCode State (or province, where applicable) code of the destination airport. OR
destinationCountryCode Country code of the flight's destination airport. US
flight The combination of the airline code and the flight number. AA 100
delayed Boolean value indicating whether the flight is delayed. true
remarks A phrase with additional information about the status of the flight, including delay information (in minutes) if appropriate. Arrived 30 minutes late
remarksWithTime A phrase with additional information about the status of the flight, including local time if appropriate. Arrived 04:27
remarksCode One of a small fixed set of strings describing the kind of remark appearing in the remarks field. See Remarks Codes. This field can be requested even if the request does not actually include the remarks field. ARRIVED_LATE
airportCode Code for the destination (for departing flights) or origin (for arrivals) airport. LHR
airportName Name of the destination (for departing flights) or origin (for arrivals) airport. London Heathrow
city Name of the destination (for departing flights) or origin (for arrivals) city. London
gate Name of the gate where the flight will depart/arrive. C12
terminal Name of the terminal where the flight will depart/arrive. C
baggage The baggage claim information for the flight arrival. 5
scheduledTime The scheduled arrival or departure time, depending on whether you asked for arrivals or departures. If you have opted to use runway times this may be a runway time if no gate time is available. 01:30
scheduledDate The scheduled arrival or departure date, depending on whether you asked for arrivals or departures. If you have opted to use runway times this may be a runway time if no gate time is available. 01/30/2013
estimatedTime The estimated arrival or departure time, depending on whether you asked for arrivals or departures. If you have opted to use runway times this may be a runway time if no gate time is available. 01:34
estimatedDate The estimated arrival or departure date, depending on whether you asked for arrivals or departures. If you have opted to use runway times this may be a runway time if no gate time is available. 01/30/2013
actualTime The actual arrival or departure time, depending on whether you asked for arrivals or departures. If you have opted to use runway times this may be a runway time if no gate time is available. 01:33
actualDate The actual arrival or departure date, depending on whether you asked for arrivals or departures. If you have opted to use runway times this may be a runway time if no gate time is available. 01/30/2013
currentTime The most accurate arrival or departure time (priority: 1. actual 2. estimated 3 scheduled), depending on whether you asked for arrivals or departures. If you have opted to use runway times this may be a runway time if no gate time is available. 01:33
currentDate The most accurate arrival or departure date (priority: 1. actual 2. estimated 3 scheduled), depending on whether you asked for arrivals or departures. If you have opted to use runway times this may be a runway time if no gate time is available. 01/30/2013
scheduledGateTime The scheduled gate arrival or departure time, depending on whether you asked for arrivals or departures. 07:40
scheduledGateDate The scheduled gate arrival or departure date, depending on whether you asked for arrivals or departures. 01/30/2013
estimatedGateTime The estimated gate arrival or departure time, depending on whether you asked for arrivals or departures. 07:50
estimatedGateDate The estimated gate arrival or departure date, depending on whether you asked for arrivals or departures. 01/30/2013
actualGateTime The actual gate arrival or departure time, depending on whether you asked for arrivals or departures. 08:05
actualGateDate The actual gate arrival or departure date, depending on whether you asked for arrivals or departures. 01/30/2013
currentGateTime The most accurate gate arrival or departure time, depending on whether you asked for arrivals or departures. 08:05
currentGateDate The most accurate gate arrival or departure date, depending on whether you asked for arrivals or departures. 01/30/2013
codesharesAsNames If this flight is marketed by multiple carriers, this fields lists those codeshare flights with the airline name and flight number. ["United Airlines 6416","ANA - All Nippon Airways 7328","Air Canada 4030"]
codesharesAsCodes If this flight is marketed by multiple carriers, this field lists those codeshare flights with the airline code and flight number. ["UA 6416","NH 7328","AC 4030"]
uplineAirportNames The names of the airports, in order, from the flight segments preceding this segment. ["Dallas/Ft. Worth International Airport","Hartsfield-Jackson Atlanta International Airport"]
uplineAirportCodes The codes of the airports, in order, from the flight segments preceding this segment. ["DFW","ATL"]
downlineAirportNames The names of the airports, in order, from the flight segments after this segment. ["Seattle/Tacoma International Airport","Vancouver International Airport"]
downlineAirportCodes The codes of the airports, in order, from the flight segments after segment. ["SEA","YVR"]
weather A short description of the weather conditions at the remote airport. Cloudy
temperatureC Air temperature, in degrees Celsius/centigrade, at the remote airport. 0
temperatureF Air temperature, in degrees Fahrenheit, at the remote airport. 32
primaryMarketingAirlineName The name of the primary marketing airline. American Airlines
primaryMarketingAirlineCode The FS code of the primary marketing airline. AA
The remarksCode field contains one of the following constant string values, indicating which general case the remarks field falls into. This can be used, for example, to select a differently-colored background for certain categories. Because the specific contents of the remarks within a category can vary (especially when using different language codes), this field provides reliable constants that are simpler to identify.
Field Description
ON_TIME Flight is expected to arrive/depart on time.
BOARDING Flight is currently boarding.
CANCELLED Flight has been cancelled.
DIVERTED Flight has been diverted.
ARRIVED_ON_TIME Flight has made an on-time arrival.
ARRIVAL_DELAYED Flight is projected to arrive late.
ARRIVED_LATE Flight has arrived, but later than scheduled.
DEPARTED_ON_TIME Flight has made an on-time departure.
DEPARTURE_DELAYED Flight is projected to depart late.
DEPARTED_LATE Flight has departed, but later than scheduled.
UNKNOWN No remarks information available for this flight.
Example XML Output
The following example is a partial response and uses inline references for simplicity.
See Full Sample Responses for a complete response.
<response> <fidsData> <flightId>298260941</flightId> <lastUpdatedTime>02:16 PM</lastUpdatedTime> <lastUpdatedTimeUtc>10:16 PM</lastUpdatedTimeUtc> <lastUpdatedDate>02/10/2013</lastUpdatedDate> <lastUpdatedDateUtc>02/10/2013</lastUpdatedDateUtc> <dayOffset>0</dayOffset> <statusCode>S</statusCode> <airlineName>SkyWest Airlines</airlineName> <airlineCode>OO</airlineCode> <flightNumber>6416</flightNumber> <airlineLogoUrlPng>http://dskx8vepkd3ev.cloudfront.net/airline-logos/v2/logos/png/300x100/oo-logo.png</airlineLogoUrlPng> <airlineLogoUrlSvg>http://dskx8vepkd3ev.cloudfront.net/airline-logos/v2/logos/svg/oo-logo.svg</airlineLogoUrlSvg> <isCodeshare>false</isCodeshare> <operatedFlightNumber>6416</operatedFlightNumber><o <operatingAirlineName>SkyWest Airlines</operatingAirlineName> <operatingAirlineCode>OO</operatingAirlineCode> <originCity>San Francisco</originCity> <originFamiliarName>San Francisco</originFamiliarName> <originStateCode>CA</originStateCode> <originCountryCode>US</originCountryCode> <destinationAirportName>Albuquerque International Airport</destinationAirportName> <destinationAirportCode>ABQ</destinationAirportCode> <destinationCity>Albuquerque</destinationCity> <destinationFamiliarName>Albuquerque</destinationFamiliarName> <destinationStateCode>NM</destinationStateCode> <destinationCountryCode>US</destinationCountryCode> <flight>OO 6416</flight> <delayed>false</delayed> <remarks>On-Time</remarks> <remarksWithTime>On-Time</remarksWithTime> <remarksCode>ON_TIME</remarksCode> <airportCode>ABQ</airportCode> <airportName>Albuquerque International Airport</airportName> <city>Albuquerque</city> <familiarName>Albuquerque</familiarName> <scheduledTime>12:50 PM</scheduledTime> <currentTime>12:50 PM</currentTime> <scheduledGateTime>12:50 PM</scheduledGateTime> <currentGateTime>12:50 PM</currentGateTime> <codesharesAsNames> <codeShareAsName>United Airlines 6416</codeShareAsName> <codeShareAsName>ANA - All Nippon Airways 7328</codeShareAsName> <codeShareAsName>Air Canada 4030</codeShareAsName> </codesharesAsNames> <codesharesAsCodes> <codeShareAsCode>UA 6416</codeShareAsCode> <codeShareAsCode>NH 7328</codeShareAsCode> <codeShareAsCode>AC 4030</codeShareAsCode> </codesharesAsCodes> <uplineAirportNames> <uplineAirportName>Portland International Airport </uplineAirportName> </uplineAirportNames> <uplineAirportCodes> <uplineAirportCode>PDX</uplineAirportCode> </uplineAirportCodes> <weather>Clear</weather> <temperatureC>5.0</temperatureC> <temperatureF>41.0</temperatureF> </fidsData> </response>
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.
{ "fidsData": [ { "flightId": "298260941", "lastUpdatedTime": "02:16 PM", "lastUpdatedTimeUtc": "10:16 PM", "lastUpdatedDate": "02/10/2013", "lastUpdatedDateUtc": "02/10/2013", "dayOffset": 0, "statusCode": "S", "airlineName": "SkyWest Airlines", "airlineCode": "OO", "flightNumber": "6416", "airlineLogoUrlPng": "http://dskx8vepkd3ev.cloudfront.net/airline-logos/v2/logos/png/300x100/oo-logo.png", "airlineLogoUrlSvg": "http://dskx8vepkd3ev.cloudfront.net/airline-logos/v2/logos/svg/oo-logo.svg", "isCodeshare": false, "operatedFlightNumber": "6416", "operatingAirlineName": "SkyWest Airlines", "operatingAirlineCode": "OO", "originCity": "San Francisco", "originFamiliarName": "San Francisco", "originStateCode": "CA", "originCountryCode": "US", "destinationAirportName": "Albuquerque International Airport", "destinationAirportCode": "ABQ", "destinationCity": "Albuquerque", "destinationFamiliarName": "Albuquerque", "destinationStateCode": "NM", "destinationCountryCode": "US", "flight": "OO 6416", "delayed": false, "remarks": "On-Time", "remarksWithTime": "On-Time", "remarksCode": "ON_TIME", "airportCode": "ABQ", "airportName": "Albuquerque International Airport", "city": "Albuquerque", "familiarName": "Albuquerque", "scheduledTime": "12:50 PM", "currentTime": "12:50 PM", "scheduledGateTime": "12:50 PM", "currentGateTime": "12:50 PM", "codesharesAsNames": [ "United Airlines 6416", "ANA - All Nippon Airways 7328", "Air Canada 4030" ], "codesharesAsCodes": [ "UA 6416", "NH 7328", "AC 4030" ], "uplineAirportNames": [ "Portland International Airport " ], "uplineAirportCodes": [ "PDX" ], "weather": "Clear", "temperatureC": 5, "temperatureF": 41 } ] }
Full Sample Responses