Developer - getRoutes


Benefit from the broad LH Cargo network: Check your product’s flight options and timing. Retrieve possible direct and connecting route offers. Enter your starting and destination stations, Lufthansa Cargo product options and a date to receive a tailor made route overview.

Routes are always up-to-date and available up to 30 days in the future.

Developer - getroutes - Request URI

Request URI

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

  • 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

Developer - getroutes - request examples

Request Examples


Developer - getroutes - response structure

Response Structure


Root element


Non-negative integer (starts with 1 and incremented by 1 for each additional request). This attribute is introduced to correlate the request and response




ShipmentOrigin represents the origin station of the routing for a shipment


ShipmentDestination represents the destination station of the routing for a shipment


This is the earliest LAT (Latest Acceptance Time) at the shipment origin station considering all routes of the response.


This is the latest TOA (Time of Availability) at the shipment destination station considering all routes of the response.


In case of later flight search, use this value as fromDate


In case of earlier flight search, use this value as fromDate


Unique 3-Letter Code to identify a Lufthansa Cargo product (see "Productcodes").

.routes: []



Represents the routing sequence number


LAT (Latest Acceptance Time) of this specific routing


TOA (Time of Availability) of this specific routing.


CO2 emission per 100 kg

...FlightSegments []

1 – n flights matching the request.


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".


Departure station of the segment


Arrival station of the segment


Flight number of the segment


Flight date of the segment


Departure date and time of the segment


Arrival date and time of the segment


Aircraft type, e. g. "77X", "333"

Developer - getroutes - response example

Response Example

  "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",
    "co2EmissionLCAG": "4733.578",
    "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",
      "co2EmissionLCAG": "7567.345",
      "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",
      "co2EmissionLCAG": "9990.843",
      "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