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. test
| 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: 96 | The number of hours before the current time for which data is wanted. | TimeFrom=1 |
| TimeTo | Optional defaults to value: 7 if not set Max value: 144 | The number of hours after the current time for which data is wanted. | 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 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 |
Please note that if incorrect syntax is used on a parameter, that parameter will be left out and its default values will be used.
Link for internal consumers in production:
https://services.avinor.no/XmlFeedOperativ/v1?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/XmlFeedOperativ/v1?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 current solution:
https://flydata.avinor.no/XmlFeedOperativ.asp?airport=BGO&TimeFrom=1&TimeTo=4&direction=A&cdm=Y&additional=Y&handlingdata=Y&gateClosedTime=Y&codeshare=Y&arrivalGate=Y
Link to test environment:
https://services-test.avinor.no/XmlFeedOperativ/v1?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
The XML schema files for the LETIS based service is obtained from the URL:
| 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 = C else BeltFirstBag = O | |
| belt_start | BeltFirstBag | ||
| belt_stop | AircraftParkingPositionArrival or ELDT or ETOT or ALDT or AIBT or NextInformationTimeAOBTATOTEOBTAircraftParkingPositionDepartureBeltLastBag | ||
| stand | Field type depends on flight direction | ||
| est_time | ELDT for Arrival, for departure If EOBT is set uses it, else ETOT | ||
| act_time | aldt if arrival, else atot if departure | ||
| onb_ofb_time | aibt if arrival, else aobt if departure | ||
| next_info | |||
| linked_flight | LinkedArrival.FlightId or LinkedDeparture.FlightId | if arrival LinkedDeparture.FlightId, else 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 | Avledes: Alltid 'N'. AltiFlightLeqQuery returnerer data for faktiske flygninger og ikke code shares. | |
| service_type | FlightServiceTypeIATA | This is the type of service provided aircraft by the one letter IATA service type code. | |
| aircraft_type | AircraftIATAType | ||
| aircraft_reg | AircraftRegistration | ||
| ramp_fuel | FuelRampRequested | ||
| tow | NA | ||
| trip_fuel | NA | ||
| zew_fuel | NA | ||
| remark_1 | RemarkData.RemarkText | If arrival will display public, if departure will not filter by type | |
| remark_2 | RemarkData.RemarkText | Will only show staff departure no matter direction | |
| cdm_tobt | TOBT | ||
| cdm_tsat | TSAT | ||
| airline | OperatingAirlineIata | ||
| flight_number | NOT in model (Part of FlightId) | Is derived from FlightId | |
| status | NextInformationTime, AOBT, ATOT, EOBT, ETOT, ELDT | If status_code = ’’: status_time = ’’ If status_code = ’N’: status_time = ’NEXT_INFO’ If status_code = ’E’: status_time = ’EOBT / ETOT’ - for departures, ’ELDT’ - for arrivals If status_code = ’D’: status_time = ’OFF_BLOCK_TIME’ – for departures If status_code = ’A’: status_time = ’ELDT’ – for arrivals If status_code = ’C’: status_time = ’’ | |
| delayed | NA | Is derived: calculated (ALDT, ELDT, SIBT) for arrival or (AOBT, ETOT, SOBT) for departure. | |
| 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 |
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).