Developer - getRoutes

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

GET https://api.lhcargo.com/routes/get?origin={origin}&destination={destination}&fromDate={fromDate}&productCode={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 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

GET https://api.lhcargo.com/routes/get?origin=FRA&destination=HKG&fromDate=2017-07-20&productCode=YNZ

Developer - getroutes - response structure

Response Structure

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.

co2EmissionLCAG

CO2 emission per 100 kg

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

Flight date of the segment

....departureDateTimeLocal

Departure date and time of the segment

....arrivalDatetimeLocal

Arrival date and time of the segment

....aircraftType

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