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
      }]
    }
  ]
}