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