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 /v2/cargo/routes/get?origin={shipmentOrigin}&destination={shipmentDestination}&fromDate={earliestDeliveryTime}&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 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 /v2/cargo/routes/get?origin=FRA&destination=HKG&fromDate=2019-12-18&productCode=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
{ "getRoutesResponse":{
"requestID":1.0,
"routes":[
{
"earliestTimeOfAvailabilityOfRouting":"2019-12-19T12:50:00+08:00",
"FlightSegments":[
{
"aircraftType":"77W",
"flightOriginDate":"2019-12-18T00:00:00+01:00",
"flightSegmentDestination":"HKG",
"flightSegmentNo":1.0,
"departureDateTimeLocal":"2019-12-18T12:25:00+01:00",
"flightNumber":"CX288",
"flightSegmentOrigin":"FRA",
"arrivalDatetimeLocal":"2019-12-19T06:50:00+08:00"
}
],
"latestAcceptanceTimeOfRouting":"2019-12-18T04:25:00+01:00",
"routeNo":1.0
},
{
"earliestTimeOfAvailabilityOfRouting":"2019-12-19T17:05:00+08:00",
"FlightSegments":[
{
"aircraftType":"M1F",
"flightOriginDate":"2019-12-18T00:00:00+01:00",
"flightSegmentDestination":"HKG",
"flightSegmentNo":1.0,
"departureDateTimeLocal":"2019-12-18T15:50:00+01:00",
"flightNumber":"LH8464",
"flightSegmentOrigin":"FRA",
"arrivalDatetimeLocal":"2019-12-19T12:05:00+08:00"
}
],
"latestAcceptanceTimeOfRouting":"2019-12-18T09:50:00+01:00",
"routeNo":2.0
},
{
"earliestTimeOfAvailabilityOfRouting":"2019-12-19T22:20:00+08:00",
"FlightSegments":[
{
"aircraftType":"74H",
"flightOriginDate":"2019-12-18T00:00:00+01:00",
"flightSegmentDestination":"HKG",
"flightSegmentNo":1.0,
"departureDateTimeLocal":"2019-12-18T22:15:00+01:00",
"flightNumber":"LH796",
"flightSegmentOrigin":"FRA",
"arrivalDatetimeLocal":"2019-12-19T16:20:00+08:00"
}
],
"latestAcceptanceTimeOfRouting":"2019-12-18T16:15:00+01:00",
"routeNo":3.0
},
{
"earliestTimeOfAvailabilityOfRouting":"2019-12-19T22:40:00+08:00",
"FlightSegments":[
{
"aircraftType":"321",
"flightOriginDate":"2019-12-18T00:00:00+01:00",
"flightSegmentDestination":"MUC",
"flightSegmentNo":1.0,
"departureDateTimeLocal":"2019-12-18T12:15:00+01:00",
"flightNumber":"LH104",
"flightSegmentOrigin":"FRA",
"arrivalDatetimeLocal":"2019-12-18T13:10:00+01:00"
},
{
"aircraftType":"388",
"flightOriginDate":"2019-12-18T00:00:00+01:00",
"flightSegmentDestination":"HKG",
"flightSegmentNo":2.0,
"departureDateTimeLocal":"2019-12-18T22:25:00+01:00",
"flightNumber":"LH730",
"flightSegmentOrigin":"MUC",
"arrivalDatetimeLocal":"2019-12-19T16:40:00+08:00"
}
],
"latestAcceptanceTimeOfRouting":"2019-12-18T06:15:00+01:00",
"routeNo":4.0
},
{
"earliestTimeOfAvailabilityOfRouting":"2019-12-19T22:40:00+08:00",
"FlightSegments":[
{
"aircraftType":"32N",
"flightOriginDate":"2019-12-18T00:00:00+01:00",
"flightSegmentDestination":"MUC",
"flightSegmentNo":1.0,
"departureDateTimeLocal":"2019-12-18T10:15:00+01:00",
"flightNumber":"LH100",
"flightSegmentOrigin":"FRA",
"arrivalDatetimeLocal":"2019-12-18T11:10:00+01:00"
},
{
"aircraftType":"388",
"flightOriginDate":"2019-12-18T00:00:00+01:00",
"flightSegmentDestination":"HKG",
"flightSegmentNo":2.0,
"departureDateTimeLocal":"2019-12-18T22:25:00+01:00",
"flightNumber":"LH730",
"flightSegmentOrigin":"MUC",
"arrivalDatetimeLocal":"2019-12-19T16:40:00+08:00"
}
],
"latestAcceptanceTimeOfRouting":"2019-12-18T04:15:00+01:00",
"routeNo":5.0
},
{
"earliestTimeOfAvailabilityOfRouting":"2019-12-19T22:40:00+08:00",
"FlightSegments":[
{
"aircraftType":"RFS",
"flightOriginDate":"2019-12-18T00:00:00+01:00",
"flightSegmentDestination":"MUC",
"flightSegmentNo":1.0,
"departureDateTimeLocal":"2019-12-18T06:10:00+01:00",
"flightNumber":"LH7264S",
"flightSegmentOrigin":"FRA",
"arrivalDatetimeLocal":"2019-12-18T13:10:00+01:00"
},
{
"aircraftType":"388",
"flightOriginDate":"2019-12-18T00:00:00+01:00",
"flightSegmentDestination":"HKG",
"flightSegmentNo":2.0,
"departureDateTimeLocal":"2019-12-18T22:25:00+01:00",
"flightNumber":"LH730",
"flightSegmentOrigin":"MUC",
"arrivalDatetimeLocal":"2019-12-19T16:40:00+08:00"
}
],
"latestAcceptanceTimeOfRouting":"2019-12-18T00:10:00+01:00",
"routeNo":6.0
},
{
"earliestTimeOfAvailabilityOfRouting":"2019-12-20T12:30:00+08:00",
"FlightSegments":[
{
"aircraftType":"32N",
"flightOriginDate":"2019-12-18T00:00:00+01:00",
"flightSegmentDestination":"ZRH",
"flightSegmentNo":1.0,
"departureDateTimeLocal":"2019-12-18T18:20:00+01:00",
"flightNumber":"LH1198",
"flightSegmentOrigin":"FRA",
"arrivalDatetimeLocal":"2019-12-18T19:10:00+01:00"
},
{
"aircraftType":"351",
"flightOriginDate":"2019-12-19T00:00:00+01:00",
"flightSegmentDestination":"HKG",
"flightSegmentNo":2.0,
"departureDateTimeLocal":"2019-12-19T11:55:00+01:00",
"flightNumber":"CX382",
"flightSegmentOrigin":"ZRH",
"arrivalDatetimeLocal":"2019-12-20T06:30:00+08:00"
}
],
"latestAcceptanceTimeOfRouting":"2019-12-18T12:20:00+01:00",
"routeNo":7.0
},
{
"earliestTimeOfAvailabilityOfRouting":"2019-12-20T12:30:00+08:00",
"FlightSegments":[
{
"aircraftType":"32A",
"flightOriginDate":"2019-12-18T00:00:00+01:00",
"flightSegmentDestination":"ZRH",
"flightSegmentNo":1.0,
"departureDateTimeLocal":"2019-12-18T16:25:00+01:00",
"flightNumber":"LH1196",
"flightSegmentOrigin":"FRA",
"arrivalDatetimeLocal":"2019-12-18T17:15:00+01:00"
},
{
"aircraftType":"351",
"flightOriginDate":"2019-12-19T00:00:00+01:00",
"flightSegmentDestination":"HKG",
"flightSegmentNo":2.0,
"departureDateTimeLocal":"2019-12-19T11:55:00+01:00",
"flightNumber":"CX382",
"flightSegmentOrigin":"ZRH",
"arrivalDatetimeLocal":"2019-12-20T06:30:00+08:00"
}
],
"latestAcceptanceTimeOfRouting":"2019-12-18T10:25:00+01:00",
"routeNo":8.0
},
{
"earliestTimeOfAvailabilityOfRouting":"2019-12-20T12:45:00+08:00",
"FlightSegments":[
{
"aircraftType":"32M",
"flightOriginDate":"2019-12-18T00:00:00+01:00",
"flightSegmentDestination":"AMS",
"flightSegmentNo":1.0,
"departureDateTimeLocal":"2019-12-18T16:30:00+01:00",
"flightNumber":"LH996",
"flightSegmentOrigin":"FRA",
"arrivalDatetimeLocal":"2019-12-18T17:45:00+01:00"
},
{
"aircraftType":"351",
"flightOriginDate":"2019-12-19T00:00:00+01:00",
"flightSegmentDestination":"HKG",
"flightSegmentNo":2.0,
"departureDateTimeLocal":"2019-12-19T12:25:00+01:00",
"flightNumber":"CX270",
"flightSegmentOrigin":"AMS",
"arrivalDatetimeLocal":"2019-12-20T06:45:00+08:00"
}
],
"latestAcceptanceTimeOfRouting":"2019-12-18T10:30:00+01:00",
"routeNo":9.0
},
{
"earliestTimeOfAvailabilityOfRouting":"2019-12-20T12:45:00+08:00",
"FlightSegments":[
{
"aircraftType":"32A",
"flightOriginDate":"2019-12-18T00:00:00+01:00",
"flightSegmentDestination":"AMS",
"flightSegmentNo":1.0,
"departureDateTimeLocal":"2019-12-18T12:30:00+01:00",
"flightNumber":"LH992",
"flightSegmentOrigin":"FRA",
"arrivalDatetimeLocal":"2019-12-18T13:45:00+01:00"
},
{
"aircraftType":"351",
"flightOriginDate":"2019-12-19T00:00:00+01:00",
"flightSegmentDestination":"HKG",
"flightSegmentNo":2.0,
"departureDateTimeLocal":"2019-12-19T12:25:00+01:00",
"flightNumber":"CX270",
"flightSegmentOrigin":"AMS",
"arrivalDatetimeLocal":"2019-12-20T06:45:00+08:00"
}
],
"latestAcceptanceTimeOfRouting":"2019-12-18T06:30:00+01:00",
"routeNo":10.0
},
{
"earliestTimeOfAvailabilityOfRouting":"2019-12-20T12:50:00+08:00",
"FlightSegments":[
{
"aircraftType":"77W",
"flightOriginDate":"2019-12-19T00:00:00+01:00",
"flightSegmentDestination":"HKG",
"flightSegmentNo":1.0,
"departureDateTimeLocal":"2019-12-19T12:25:00+01:00",
"flightNumber":"CX288",
"flightSegmentOrigin":"FRA",
"arrivalDatetimeLocal":"2019-12-20T06:50:00+08:00"
}
],
"latestAcceptanceTimeOfRouting":"2019-12-19T04:25:00+01:00",
"routeNo":11.0
}
],
"routeHeaderInformation":{
"latestTOAFromOfferedRoutings":"2019-12-20T00:01:00+08:00",
"productCode":"YNZ",
"latForLaterFlightSearch":"2019-12-19T22:16:00+01:00",
"toaForEarlierFlightSearch":"2019-12-19T06:49:00+08:00",
"shipmentDestination":"HKG",
"earliestLATFromOfferedRoutings":"2019-12-18T00:01:00+01:00",
"shipmentOrigin":"FRA"
}
}
}
Docs Navigation
- Lufthansa Open API
- Getting Started
- Public API Method Details
- Cargo
- Flight Schedules
- Reference Data
- Offers
- Operations
- Flight Schedules
- Flight Status
- Flight Status by Route
- Flight Status at Arrival Airport
- Flight Status at Departure Airport
- Flight Status Response
- Flight Status at Arrival Airport or Departure Response
- Customer Flight Information
- Customer Flight Information at Arrival Airport
- Customer Flight Information by Route
- Customer Flight Information at Departure Airport
- Customer Flight Information Response
- Notifications
- Partner API Method Details
- FlightOps/Crew API Method Details