Parameters for the request operations
All parameters are optional except parameter airport.
NB! All the parameters and its values are case-sensitive.
The semantics of each parameter are described in the table below.
| Parameter | Values | Description / Comments | For example |
|---|---|---|---|
| airport | Required max: 3-4 characters value, ex. OSL, BGO, TOS | The operating airport that considers the flight leg orientations. Formatting is given as IATA airport code and must written in uppercase letters. Parameter is required! | airport=OSL, airport=BGO, etc. |
| TimeFrom | Optional defaults to value: 1 if not set Max value: 9636 | The number of hours before the current time for which data is wanted. Example: Flights are selected based on ProbOBT from ARDB. | TimeFrom=1 |
| TimeTo | Optional defaults to value: 7 if not set Max value: 144744 | The number of hours after the current time for which data is wanted. Example: Flights are selected based on ProbIBT from ARDB. | TimeTo=7 |
| direction | Optional Accepted: A or D If not set: both flight-directions | If the parameter direction is set, then the Flights will be filtered by A=Arrivals or D=Departures. If parameter direction is not set then fetch all flight leg data for both orientations. | direction=A or direction=D |
| cdm | Optional Accepted: Y | If cdm=Y is set then cdm data as TOBT, TSAT and EIBT is added to the flight. If not set cdm data is not added. | cdm=Y |
| additional | Optional Accepted: Y | if the parameter additional is set to “Y” then additional data as Airline, Flight Number, Status and Delayed is , Delayed and some passenger numbers are added to Flight. | additional=Y |
| lastUpdate | Optional Accepted format: yyyy-MM-ddTHH:mm:ssZ ex: 2023-01-20T13:02:37Z | If set, then Flights that are updated after the given timestamp within the period of TimeFrom and TimeTo. Datetime has to be given in UTC/Z zone. Recommended for polling-applications looking for new updates to flights. | lastUpdate=2023-01-03T09:30:00Z |
| handlingdata | Optional Accepted: Y | If handlingdata=Y is set then HandlerData as HandlerCode, HandlerName and HandlerServiceType is added to flights. If not set, HandlerData is not added. | handlingdata=Y |
| gateClosedTime | Optional Accepted: Y | If set then gateClosedTime will be added to departure-flights with a gateClosedTime, if the data exists. Example value of gateClosedTime: 2023-03-14T10:35:12Z | gateClosedTime=Y |
| codeshare | Optional Accepted: Y | If set then codeshareinfo is added to flight. CodeshareInfo consists of codeshareAirlineDesignators, codeshareAirlineNames, codeshareFlightNumbers and codeshareOperationalSuffixs. | codeshare=Y |
| arrivalGate | Optional Accepted: Y | If set then gate is added to arrival-flight. | arrivalGate=Y |
| atm | Optional Accepted: Y | If atm=Y is set, then ATM Estimated Landing Time (ELDT) is added to the flight. If not set, ELDT data is not added. | atm=Y |
Please note that if incorrect syntax is used on a parameter, that parameter will be left out and its default values will be used.
Examples where parameters are used in url:
TestLink for internal consumers in production:
https://services-test.avinor.no/XmlFeedOperative/v1.0?airport=BGO&TimeFrom=1&TimeTo=4&direction=A&cdm=Y&additional=Y&lastUpdate=2023-01-20T13:02:37.340Z&handlingdata=Y&gateClosedTime=Y&codeshare=Y&arrivalGate=Y
Link for external consumers in production:
https://asrv.avinor.no/XmlFeedOperativXmlFeedOperative/v1.0?airport=BGO&TimeFrom=1&TimeTo=4&direction=A&cdm=Y&additional=Y&lastUpdate=2023-01-20T13:02:37.340Z&handlingdata=Y&gateClosedTime=Y&codeshare=Y&arrivalGate=Y
Link to test environmentProd:
https://asrvservices-test.avinor.no/XmlFeedOperativXmlFeedOperative/v1.0?airport=BGO&TimeFrom=1&TimeTo=4&direction=A&cdm=Y&additional=Y&lastUpdate=2023-01-20T13:02:37.340Z&handlingdata=Y&gateClosedTime=Y&codeshare=Y&arrivalGate=Y
General sorting rules
The flights are sorted on: schedule_time, flight_id
XML schema file.
The XML schema files for the LETIS based service is obtained from the URL:
Service field mapping
| Service term | ADD term | ARDB column | Comment | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| flight_id | FlightId (NB! Is formatted) | flight_id | ||||||||||
| date_of_operation | FlightDepartureDate (NB! Response is DateTime)flight_departure_date | |||||||||||
| dom_int | FlightDIIndicatorflight_di_indicator | |||||||||||
| schedule_time | SIBT for arrivals, SOBT for departures | sibt, sobt | ||||||||||
| arr_depNA | NA | "A" - Arrival, "D" - Departure | ||||||||||
| airport | ArrivalAirportIATA or DepartureAirportIATA | arrival_airport_iata, departure_airport_iata | ||||||||||
| via_airport | FlightRouteIATA | flight_route_iata | Is derived from flightId, multi flight, +++ | |||||||||
| check_in | CheckInDisplayText | check_in_display_text | ||||||||||
| gate | Gate | |||||||||||
| gate_datagate_status | GateStatus | gate_data | ||||||||||
| belt | BaggageClaimUnit | baggage_claim_unit | ||||||||||
| belt_status | Is derived: BeltLastBag or BeltFirstBag | If BeltLastBag is set, belt_last_bag or belt_first_bagIf BeltLastBag status = C else if BeltFirstBag is set, belt_status = O | ||||||||||
| belt_start | BeltFirstBagbelt_first_bag | |||||||||||
| belt_stop | AircraftParkingPositionArrival or ELDT or ETOT or ALDT or AIBT or NextInformationTimeAOBTATOTEOBTAircraftParkingPositionDepartureBeltLastBag | belt_last_bag | BeltLastBag | |||||||||
| stand | AircraftParkingPositionArrival or AircraftParkingPositionDeparture | stand | aircraft_parking_position_arrival, aircraft_parking_position_departure | Field type depends on flight direction | ||||||||
| est_time | Departure Empty if NextInformationTime is present. | Departure Arrival | ||||||||||
| act_time | ALDT or ATOT | Arrival: ALDT. Departure: ATOT | eldt, etot, eobt | ELDT for Arrival, for departure If EOBT is set uses it, else ETOT | act_time | aldt, atot | aldt if arrival, else atot if departure | |||||
| onb_ofb_time | aibt, aobt | AIBT or AOBT | Arrival: AIBT. Departure: AOBTaibt if arrival, else aobt if departure | |||||||||
| next_info | NextInformationTime | The dateTime of next _information_timeinformation. If 'NextInformationTime' is present, then 'est time' is NOT included in the response. | ||||||||||
| linked_flight | LinkedArrival.FlightId or LinkedDeparture.FlightId | lnk_arv_flight_id, lnk_dep_flight_id | if arrival Arrival: LinkedDeparture.FlightId, else departure . Departure: LinkedArrival.FlightId | |||||||||
| linked_flight_keyNA | NA | |||||||||||
| last_delay_code | ArrivalDelay or or DepartureDelay | arrival_delay or departure_delay | ||||||||||
| last_delay_code2 | ArrivalDelay or DepartureDelayarrival_delay or departure_delay | |||||||||||
| cancelled_flag | FlightLegStatus | flight_leg_status | Checks if flight status is "CANCELED" returns true/false | |||||||||
| cdm_eibt | EIBTeibt | |||||||||||
| codeshare_ind | NA | NA | AvledesDerived: Alltid always 'N'. AltiFlightLeqQuery returnerer return data for faktiske flygninger og ikke actual flights and not code shares.. | |||||||||
| service_type | FlightServiceTypeIATA | flight_service_type_iata | This is the type of service provided aircraft by the one One letter IATA service type code e.g. ‘J’ (Schedule passenger) and ‘C’ (Charter passenger). There are no restrictions on service type. | |||||||||
| aircraft_type | AircraftIATAType | |||||||||||
| aircraft_iata_typeaircraft_reg | AircraftRegistrationaircraft_registration | |||||||||||
| ramp_fuel | FuelRampRequested | fuel_ramp_requested | tow | NA | NA | trip_fuel | NA | NA | zew_fuel | NA | NA | |
| remark_1 | RemarkData.RemarkText | flight_leg_remark | If arrival will display public, if departure will not filter by typePublic remark, shown on Public Surfaces, such as FIDS screens and web pages. | |||||||||
| remark_2 | RemarkData.RemarkText | flight_leg_remark | Will only show staff departure no matter directionStaff remark, only shown to handlers, airline and airport employees. Visible in mAOS and flightviewer. | |||||||||
| cdm_tobt | TOBT | tobt | ||||||||||
| cdm_tsat | TSAT | tsat | ||||||||||
| airline | OperatingAirlineIata | operating_airline_iata | ||||||||||
| flight_number | NOT in model (Part of FlightId) | NOT in model | Is derived from FlightId | |||||||||
| status | NextInformationTime, ALDT, AIBT, ELDT, SIBT, AOBT, ATOT, EOBT, ETOT, ELDTnext_information_time, aobt, atot, eobt, etot, eldt SOBT, AirlineELDT, AirlineEOBT | If status_code = ’’: status_time = ’’ If status_code = ’N’: status_time = ’NEXT_INFO’ If status_code = ’E’: status_time = ’EOBT 'AirlineELDT'/ ETOT’ ’ELDT’ - for departures, ’ELDT’ arrivals, 'AirlineEOBT'/’EOBT’ or 'ETOT' - for arrivals departures If status_code = ’D’: status_time = ’OFF_BLOCK_TIME’ ’AOBT’ or 'ATOT' – for departures If status_code = ’A’: status_time = ’ELDT’ ’ALDT’ or 'AIBT' – for arrivals If status_code = ’C’: status_time = ’’ If AirlineELDT or AirlineEOBT are empty, use the ATM estimated times (e.g. ELDT, EOBT) | ||||||||||
| delayed | NA | NA | Arrival: Is derived from ProbLDT, ProbIBT, SIBT. Departure: Is derived from ProbOBT, SOBT. delayed = Y if SIBT/SOBT - Prob time > 15 min After summer vacation 2026, this definition will be implemented: Arrival | |||||||||
| codeshare_key | NA | NA | ||||||||||
| handlingAgent | ArrivalData.HandlerName or DepartureData.HandlerName | handler_arrival or handler_departure | ||||||||||
| handlingAgentCode | ArrivalData.HandlerCode or DepartureData.HandlerCode | handler_arrival or handler_departure | ||||||||||
| flight_leg_key | NA | NA | ||||||||||
| gateClosedTime | GateClosegate_data | Example value: 2023-03-14T10:35:12Z | ||||||||||
| codeshareAirlineDesignators | NA | code_share | ||||||||||
| codeshareAirlineNames | CodeshareAirlineIATAcode_share | |||||||||||
| codeshareFlightNumbers | CodeshareFlightNumber | code_share | ||||||||||
| codeshareOperationalSuffixs | NA | code_share |
Time specifications:
All times are listed in UTC format and are in the format ISO 8601 (Wikipedia: ISO 8601-format) [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss]Z. Please make sure to adjust for
...
time zone and summer time as required.
Example: 2009-12-31T16:00:00 corresponds to 31. Descember 2009 17:00 o'clock local time in Norway (CET), while 2009-06-23T16:00:00 correcsponds to 23. June 2009 18:00 o'clock local time in Norway (Summertime).
...
For more information about each field please look: Avinor Data Definition
References
- Airport Data Dictionary
- AltiFlightLegQuery
- Format of XMLfeed Operativ v1-10 (word document)