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