Get Route

Retrieve a list of all possible flights from a LH CARGO perspective (both direct and connecting) between two airports on a given date.

Routes are available for today and up to 30 days in the future.

Request URI

GET /v1/cargo/getRoute/{origin}-{destination}/{fromDate}/{productCode}

Variable	Description	Format
{origin}	Departure airport.	3-letter IATA airport code, e.g. “FRA”.
{destination}	Arrival airport.	3-letter IATA airport code e.g. "HKG"
{fromDate}	Departure date in the local time of the departure airport. Based on LAT (Latest Acceptance Time)	yyyy-MM-dd
{productCode}	Product code for requested service and specials	3-letter product code eg: "YNZ" . please refer below table for all possible values

{ProductCode}	{Description}
FAN	Service: td.Flash, Special: Safe/td 1
FCO	Service: td.Flash, Special: Cool/td active
FCP	Service: td.Flash, Special: Cool/td passive
FDG	Service: td.Flash, Special: Care/td
FTF	Service: td.Flash, Special: Fresh/td
FUN	Service: td.Flash, Special: Safe/td 2
FWN	Service: td.Flash, Special: Live/td
YCO	Service: td.Pro, Special: Cool/td active
YCP	Service: td.Pro, Special: Cool/td passive
YDG	Service: td.Pro, Special: Care/td
YNB	Service: td.Pro, Special: BUP
YNZ	Service: td.Pro, Special: [none]
YTF	Service: td.Pro, Special: Fresh/td
YUN	Service: td.Pro, Special: Safe/td 2
ZXB	Service: td.Flash, Special: BUP
ZXF	Service: td.Flash, Special: [none]
ZXR	Service: td.Flash, Special: Courier Solutions

Request Examples

GET /cargo/getRoute/FRA-HKG/2017-07-20/YNZ

Response Structure

Key	Description
getRoutesResponse	Root element
.requestID	Non negative integer (starts with 1 and incremented by 1 for each additional request). This attribute is introduced to correlate the request and response
.routeHeaderInformation
..shipmentOrigin	ShipmentOrigin represents the origin station of the routing for a shipment
..shipmentDestination	ShipmentDestination represents the destination station of the routing for a shipment
..earliestLATFromOfferedRoutings	This is the earliest LAT (Latest Acceptance Time) at the shipment origin station considering all routes of the response.
..latestTOAFromOfferedRoutings	This is the latest TOA (Time of Availability) at the shipment destination station considering all routes of the response.
..latForLaterFlightSearch	In case of later flight search, use this value as fromDate
..toaForEarlierFlightSearch	In case of earlier flight search, use this value as fromDate
..productCode	Unique 3-Letter Code to identify a Lufthansa Cargo product (see "Productcodes").
.routes: []
...routeNo	Represents the routing sequence number
...latestAcceptanceTimeOfRouting	LAT (Latest Acceptance Time) of this specific routing
...earliestTimeOfAvailabilityOfRouting	TOA (Time of Availability) of this specific routing.
...FlightSegments []	1 – n flights matching the request.
....flightSegmentNo	Serial number of the segment in the route. If the route is HAM-FRA-JFK, then the segment HAM-FRA gets "1" and the segment FRA-JFK gets "2".
....flightSegmentOrigin	Departure station of the segment
....flightSegmentDestination	Arrival station of the segment
....flightNumber	Flight number of the segment
....flightOriginDate	Departure time of the segment
....departureDateTimeLocal	Arrival time of the segment
....arrivalDatetimeLocal	Aircraft type of the segment
....aircraftType	Serial number of the segment in the route. If the route is HAM-FRA-JFK, then the segment HAM-FRA gets "1" and the segment FRA-JFK gets "2".

Response Example

Code snippet: Json

{
  "requestID": 1,
  "routeHeaderInformation": {
    "shipmentOrigin": "FRA",
    "shipmentDestination": "HKG",
    "earliestLATFromOfferedRoutings": "2017-07-15T00:50:00",
    "latestTOAFromOfferedRoutings": "2017-07-17T17:10:00",
    "latForLaterFlightSearch": "2017-07-16T11:51:00",
    "toaForEarlierFlightSearch": "2017-07-16T09:24:00",
    "productCode": "YNZ"
  },
  "routes": [{
    "routeNo": 1,
    "latestAcceptanceTimeOfRouting": "2017-07-15T09:40:00" ,
    "earliestTimeOfAvailabilityOfRouting": "2017-07-16T14:25:00",
    "FlightSegments": {
      "flightSegmentNo": 1,
      "flightSegmentOrigin": "FRA",
      "flightSegmentDestination": "HKG",
      "flightNumber": "LH8082",
      "flightOriginDate": "2017-07-15T00:00:00",
      "departureDateTimeLocal": "2017-07-15T15:40:00",
      "arrivalDatetimeLocal": "2017-07-16T09:25:00",
      "aircraftType": "77F"
    }
    }, {
      "routeNo": 2,
      "latestAcceptanceTimeOfRouting": "2017-07-15T16:10:00",
      "earliestTimeOfAvailabilityOfRouting": "2017-07-16T21:25:00",
      "FlightSegments": {
        "flightSegmentNo": 1,
        "flightSegmentOrigin": "FRA",
        "flightSegmentDestination": "HKG",
        "flightNumber": "LH796",
        "flightOriginDate": "2017-07-15T00:00:00",
        "departureDateTimeLocal": "2017-07-15T22:10:00",
        "arrivalDatetimeLocal": "2017-07-16T15:25:00",
        "aircraftType": 388
      }
    }, {
      "routeNo": 3,
      "latestAcceptanceTimeOfRouting": "2017-07-15T05:50:00",
      "earliestTimeOfAvailabilityOfRouting": "2017-07-16T17:10:00",
      "FlightSegments": [{
        "flightSegmentNo": 1,
        "flightSegmentOrigin": "FRA",
        "flightSegmentDestination": "VIE",
        "flightNumber": "LH1238",
        "flightOriginDate": "2017-07-15T00:00:00",
        "departureDateTimeLocal": "2017-07-15T11:50:00",
        "arrivalDatetimeLocal": "2017-07-15T13:10:00",
        "aircraftType": "32V"
      }, {
        "flightSegmentNo": 2,
        "flightSegmentOrigin": "VIE",
        "flightSegmentDestination": "HKG",
        "flightNumber": "OS067",
        "flightOriginDate": "2017-07-15T00:00:00",
        "departureDateTimeLocal": "2017-07-15T17:45:00",
        "arrivalDatetimeLocal": "2017-07-16T11:10:00",
        "aircraftType": 772
      }]
    }
  ]
}

version 31 as of 11 months ago by Matthias