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: 36 | 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: 744 | 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, 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:
Link for internal consumers in production:
https://services.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/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 to test environment:
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
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 | Comment |
|---|---|---|
| flight_id | FlightId (NB! Is formatted) | |
| date_of_operation | FlightDepartureDate (NB! Response is DateTime) | |
| dom_int | FlightDIIndicator | |
| schedule_time | SIBT for arrivals, SOBT for departures | |
| arr_dep | NA | "A" - Arrival, "D" - Departure |
| airport | ArrivalAirportIATA or DepartureAirportIATA | |
| via_airport | FlightRouteIATA | Is derived from flightId, multi flight, +++ |
| check_in | CheckInDisplayText | |
| gate | Gate | |
| gate_status | GateStatus | |
| belt | BaggageClaimUnit | |
| belt_status | Is derived: BeltLastBag or BeltFirstBag | If BeltLastBag is set, belt_status = C else if BeltFirstBag is set, belt_status = O |
| belt_start | BeltFirstBag | |
| belt_stop | BeltLastBag | |
| stand | AircraftParkingPositionArrival or AircraftParkingPositionDeparture | 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 |
| onb_ofb_time | AIBT or AOBT | Arrival: AIBT. Departure: AOBT |
| next_info | NextInformationTime | The dateTime of next information. If 'NextInformationTime' is present, then 'est time' is NOT included in the response. |
| linked_flight | LinkedArrival.FlightId or LinkedDeparture.FlightId | Arrival: LinkedDeparture.FlightId. Departure: LinkedArrival.FlightId |
| linked_flight_key | NA | |
| last_delay_code | ArrivalDelay or DepartureDelay | |
| last_delay_code2 | ArrivalDelay or DepartureDelay | |
| cancelled_flag | FlightLegStatus | Checks if flight status is "CANCELED" returns true/false |
| cdm_eibt | EIBT | |
| codeshare_ind | NA | Derived: always 'N'. AltiFlightLeqQuery return data for actual flights and not code shares.. |
| service_type | FlightServiceTypeIATA | 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_reg | AircraftRegistration | |
| ramp_fuel | FuelRampRequested | |
| remark_1 | RemarkData.RemarkText | Public remark, shown on Public Surfaces, such as FIDS screens and web pages. |
| remark_2 | RemarkData.RemarkText | Staff remark, only shown to handlers, airline and airport employees. Visible in mAOS and flightviewer. |
| cdm_tobt | TOBT | |
| cdm_tsat | TSAT | |
| airline | OperatingAirlineIata | |
| flight_number | NOT in model (Part of FlightId) | Is derived from FlightId |
| status | NextInformationTime, ALDT, AIBT, ELDT, SIBT, AOBT, ATOT, EOBT, ETOT, SOBT, AirlineELDT, AirlineEOBT | If status_code = ’’: status_time = ’’ If status_code = ’N’: status_time = ’NEXT_INFO’ If status_code = ’E’: status_time = 'AirlineELDT'/’ELDT’ - for arrivals, 'AirlineEOBT'/’EOBT’ or 'ETOT' - for departures If status_code = ’D’: status_time = ’AOBT’ or 'ATOT' – for departures If status_code = ’A’: status_time = ’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 | 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 | |
| handlingAgent | ArrivalData.HandlerName or DepartureData.HandlerName | |
| handlingAgentCode | ArrivalData.HandlerCode or DepartureData.HandlerCode | |
| flight_leg_key | NA | |
| gateClosedTime | GateClose | Example value: 2023-03-14T10:35:12Z |
| codeshareAirlineDesignators | NA | |
| codeshareAirlineNames | CodeshareAirlineIATA | |
| codeshareFlightNumbers | CodeshareFlightNumber | |
| codeshareOperationalSuffixs | NA |
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).