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.
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
|
Request Examples
GET https://api.lhcargo.com/routes/get?origin=FRA&destination=HKG&fromDate=2017-07-20&productCode=YNZ
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" |
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
}]
}
]
}