{"note":"OpenAPI conversion -- returning structured metadata","name":"lufthansa-com-partner","description":"LH Partner API","version":"1.0","base_url":"https://api.lufthansa.com/v1","endpoints":16,"raw":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api LH Partner API\n@base https://api.lufthansa.com/v1\n@version 1.0\n@auth OAuth2\n@endpoints 16\n@toc promotions(1), references(1), orders(1), preflight(1), baggage(1), offers(11)\n\n@group promotions\n@endpoint GET /promotions/priceoffers/flights/ond/{origin}/{destination}\n@desc Price Offers\n@required {origin: any # Departure city. 3-letter IATA city code, destination: any # Destination city. 3-letter IATA city code, departureDate: any # Departure date in local time (YYYY-MM-DD), returnDate: any # Return date in local time (YYYY-MM-DD)}\n@optional {service: any # Optional parameter.}\n@returns(200)\n\n@endgroup\n\n@group references\n@endpoint GET /references/seatdetails/{aircraftCode}/{cabinCode}\n@desc Seat Details\n@required {aircraftCode: any # Aircraft type. 3-character IATA equipment code, Accept: any # http header: application/json or application/xml (Acceptable values are: \"application/json\", \"application/xml\"), cabinCode: any # Cabin class: M, E, C, F (Acceptable values are: \"\", \"M\", \"E\", \"C\", \"F\")}\n@optional {lang: any # 2-letter ISO 3166-1 language code}\n@returns(200)\n\n@endgroup\n\n@group orders\n@endpoint GET /orders/orders/{orderID}/{name}\n@desc Orders\n@required {orderID: any # Unique order identifier, Accept: any # http header: application/json or application/xml (Acceptable values are: \"application/json\", \"application/xml\"), name: any # Surname of traveller}\n@returns(200)\n\n@endgroup\n\n@group preflight\n@endpoint PUT /preflight/autocheckin/{ticketnumber}\n@desc Auto Check-In\n@required {ticketnumber: any # Ticket number, emailAddress: any # Email address, Accept: any # http header: application/json or application/xml (Acceptable values are: \"application/json\", \"application/xml\")}\n@returns(200)\n\n@endgroup\n\n@group baggage\n@endpoint GET /baggage/baggagetripandcontact/{searchID}\n@desc Baggage Trip and Contact\n@required {searchID: any # Bag tag number, PNR, boarding card or FQTV ID, Accept: any # http header: application/json or application/xml (Acceptable values are: \"application/json\", \"application/xml\")}\n@returns(200)\n\n@endgroup\n\n@group offers\n@endpoint GET /offers/fares/fares\n@desc Fares\n@required {catalogues: any # Search fares from these carriers' catalogues - currently active for Germanwings only  (4U), segments: any # Journey details  e.g. (origin=TXL;destination=CGN;travel-date=2016-12-15;return-date=2016-12-20;cabin=Economy), carriers: any # Include fares for these carriers e.g. ('4U;LH'), Accept: any # http header: application/json or application/xml (Acceptable values are: \"application/json\", \"application/xml\")}\n@optional {travelers: any # Type and number of travelers e.g. (adult=1;child=1;infant=1), fare-types: any # Fares family: basic,smart, best, smartflex, bestflex - Germanwings only (Acceptable values are: \"\", \"basic\", \"smart\", \"best\", \"smartflex\", \"bestflex\")}\n@returns(200)\n\n@endpoint GET /offers/fares/allfares\n@desc All Fares\n@required {catalogues: any # Specifies in which catalogue the fares need to be searched (e.g.'4U;OS')., origin: any # Enter journey origin (e.g 'FRA')., destination: any # Enter journey destination (e.g 'MAD')., travel-date: any # Enter journey travel-date (e.g 2016-10-20)}\n@optional {return-date: any # Enter journey return-date (e.g 2016-10-31)'., cabin-class: any # Enter the required cabin class (e.g econonmy, business etc.). (Acceptable values are: \"\", \"economy\", \"premium economy\", \"business\", \"first\"), travelers: any # Specifies the type and number of travelers (e.g. '(adult=2;child=2;infant=1)') For LH only (adult=1) possible., fare-family: any # Mandatory for 4U. Specifies, which fares to be returned, such as basic, smart, best, smartflex, bestflex . (Acceptable values are: \"\", \"basic\", \"smart\", \"best\", \"smartflex\", \"bestflex\"), trackingid: any # Austrian Airlines only - specify the web tracking id to be used in OS Deep link., Accept: any # Mandatory http header:  application/xml or application/json}\n@returns(200)\n\n@endpoint GET /offers/fares/lowestfares\n@desc Lowest Fares\n@required {catalogues: any # Search fares from these carriers' catalogues e.g. '4U;OS;LH', origin: any # Journey origin. 3-letter IATA aiport code e.g. 'FRA', destination: any # Journey destination. 3-letter IATA airport code e.g. 'MAD', travel-date: any # Journey travel-date YYYY-MM-DD, Accept: any # http header: application/json or application/xml (Acceptable values are: \"application/json\", \"application/xml\")}\n@optional {return-date: any # Journey return-date - mandatory for OS and LH searches YYYY-MM-DD, cabin-class: any # Cabin class: 'economy', 'premium_economy', 'business', 'first' (Acceptable values are: \"\", \"economy\", \"premium_economy\", \"business\", \"first\"), travelers: any # Type and number of travelers e.g. '(adult=2;child=2;infant=1)'. For LH only (adult=1) possible, fare-family: any # Fare family: basic, smart, best, smartflex, bestflex - Germanwings only (Acceptable values are: \"\", \"basic\", \"smart\", \"best\", \"smartflex\", \"bestflex\"), country: any # Country code of requestor. 2-letter ISO 3166-1 country code (e.g. 'de')}\n@returns(200)\n\n@endpoint GET /offers/fares/bestfares\n@desc Best Fares\n@required {catalogues: any # Search fares from these carriers' catalogues (e.g. '4U;OS;LH'), origin: any # Journey origin. 3-letter IATA airport code (e.g. 'FRA'), destination: any # Journey destination. 3-letter IATA airport code (e.g. 'MAD'), travel-date: any # Journey travel-date (YYYY-MM-DD), trip-duration: any # Trip duration in days (e.g. '7'), range: any # Fare range: 'byday' or 'bymonth' (Acceptable values are: \"byday\", \"bymonth\"), Accept: any # http header: application/json or application/xml (Acceptable values are: \"application/json\", \"application/xml\")}\n@optional {cabin-class: any # Cabin class: 'economy', 'premium_economy', 'business', 'first' (Acceptable values are: \"\", \"economy\", \"premium_economy\", \"business\", \"first\"), country: any # Country code of requestor. 2-letter ISO 3166-1 country code (e.g. 'de'), trackingid: any # Austrian Airlines only - specify the web tracking id to be used in OS Deep link., fare-family: any # Fare family: basic, smart, best, smartflex, bestflex - Germanwings only (Acceptable values are: \"\", \"basic\", \"smart\", \"best\", \"smartflex\", \"bestflex\")}\n@returns(200)\n\n@endpoint GET /offers/fares/subscriptions\n@desc Fares Subscriptions\n@required {origin: any # Journey origin. 3-leter IATA airport code (e.g. 'FRA'), destination: any # Journey destination. 3-letter IATA airport code (e.g. 'MAD'), cabin-class: any # Cabin class: 'economy', 'premium_economy', 'business', 'first' (Acceptable values are: \"\", \"economy\", \"premium_economy\", \"business\", \"first\"), trip-duration: any # Trip duration in days (e.g. '7'), email: any # Email Address'), lang: any # 2-letter ISO 3166-1 language code, Accept: any # http header: application/json or application/xml (Acceptable values are: \"application/json\", \"application/xml\")}\n@optional {country: any # 2-letter ISO 3166-1 country code, trackingid: any # Tracking parameter}\n@returns(200)\n\n@endpoint GET /offers/fares/deeplink/ffp\n@desc LH Deep Links - FFP\n@required {catalogues: any # Carrier for which the deep link will be created (e.g. 'LH'), origin: any # Journey origin. 3-letter IATA airport or city code (e.g. 'FRA'), destination: any # Journey destination. 3-letter IATA airport or city code (e.g. 'MAD'), travel-date: any # Journey travel-date (YYYY-MM-DD), trackingid: any # Deep link tracking ID, country: any # 2-letter ISO 3166-1 country code, lang: any # 2-letter ISO 3166-1 language code, Accept: any # http header: application/json or application/xml (Acceptable values are: \"application/json\", \"application/xml\")}\n@optional {return-date: any # Journey return-date (YYYY-MM-DD), cabin-class: any # Cabin class: 'economy', 'premium_economy', 'business', 'first' (Acceptable values are: \"\", \"economy\", \"premium_economy\", \"business\", \"first\"), travelers: any # Type and number of travelers (e.g. '(adult=2;child=2;infant=1)'), partnerid: any # Deep link partner id (e.g. '1247'), encryption-key: any # Deep link encryption-key}\n@returns(200)\n\n@endpoint GET /offers/fares/deeplink/itco\n@desc LH Deep Links - ITCO\n@required {catalogues: any # Carrier for which the deep link will be created (e.g. 'LH'), origin: any # Journey origin. 3-letter IATA airport or city code (e.g. 'FRA'), destination: any # Journey destination. 3-letter IATA airport or city code (e.g. 'MAD'), travel-date: any # Journey travel-date (YYYY-MM-DD), outbound-segments: any # Outbound flight segments in the sequence of travel (e.g. 'LH096;LH480'), fare: any # Travel fare (e.g. '1341.45'), fare-currency: any # Fare currency (e.g. 'EUR'), trackingid: any # Deep link tracking ID, country: any # 2-letter ISO 3166-1 country code, lang: any # 2-letter ISO 3166-1 language code, Accept: any # http header: application/json or application/xml (Acceptable values are: \"application/json\", \"application/xml\")}\n@optional {return-date: any # Journey return-date (YYYY-MM-DD), cabin-class: any # Cabin class: 'economy', 'premium_economy', 'business', 'first' (Acceptable values are: \"\", \"economy\", \"premium_economy\", \"business\", \"first\"), return-segments: any # Flight segments in the sequence of travel (e.g. 'LH7465;LH431'), travelers: any # Type and number of travelers (e.g. '(adult=2;child=2;infant=1)'), net-fare: any # Travel net fare. Total fare less taxes and charges (e.g. '1140'), partnerid: any # Deep link partner id (e.g. '1247'), encryption-key: any # Deep link encryption-key}\n@returns(200)\n\n@endpoint GET /offers/fares/deeplink\n@desc Deep Links\n@required {catalogues: any # Carrier for which the deep link will be created (e.g. 'LH'), trackingid: any # Deep link tracking ID, country: any # 2-letter ISO 3166-1 country code, lang: any # 2-letter ISO 3166-1 language code, Accept: any # http header: application/json or application/xml (Acceptable values are: \"application/json\", \"application/xml\")}\n@optional {origin: any # Journey origin. 3-letter IATA airport or city code (e.g. 'FRA'), origin-name: any # Journey origin airport or city name (e.g. 'frankfurt'), destination: any # Journey destination. 3-letter IATA airport or city code (e.g. 'MAD'), destination-name: any # Journey destination airport or city name (e.g. 'madrid'), travel-date: any # Journey travel-date (YYYY-MM-DD), return-date: any # Journey return-date (YYYY-MM-DD), cabin-class: any # Cabin class: 'economy', 'premium_economy', 'business', 'first' (Acceptable values are: \"\", \"economy\", \"premium_economy\", \"business\", \"first\"), outbound-segments: any # Outbound flight segments in the sequence of travel (e.g. 'LH096;LH480'), return-segments: any # Flight segments in the sequence of travel (e.g. 'LH7465;LH431'), travelers: any # Type and number of travelers (e.g. '(adult=2;child=2;infant=1)'), fare: any # Travel fare (e.g. '1341.45'), net-fare: any # Travel net fare. Total fare less taxes and charges (e.g. '1140'), fare-currency: any # Fare currency (e.g. 'EUR'), partnerid: any # Deep link partner id (e.g. '1247'), encryption-key: any # Deep link encryption-key}\n@returns(200)\n\n@endpoint GET /offers/ond/route/{origin}/{destination}\n@desc OND Route\n@required {origin: any # Enter either the orgin city or orgin country code (e.g 'FRA' or 'DE'). Enter '*' for all, destination: any # Enter either the destination city or country code (e.g 'MAD' or 'ES'). Enter '*' for all, Accept: any # Mandatory http header:  application/xml or application/json}\n@optional {catalogues: any # Carrier for which the OND will be retrieved (e.g. 'LH'), limit: any # Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is given, 100 will be taken), offset: any # Number of records skipped. Defaults to 0}\n@returns(200)\n\n@endpoint GET /offers/ond/top\n@desc Top OND\n@required {Accept: any # Mandatory http header:  application/xml or application/json}\n@optional {catalogues: any # Carrier for which the OND will be retrieved (e.g. 'LH'), origin: any # Enter the origin country code (e.g. 'DE'). Leave empty to search Top OND across all countries}\n@returns(200)\n\n@endpoint GET /offers/ond/status\n@desc OND Status\n@required {Accept: any # Mandatory http header:  application/xml or application/json}\n@optional {catalogues: any # Carrier for which the OND will be retrieved (e.g. 'LH'), new-routes: any # Enter if newly added routes should be returned in the response. (Acceptable values are: \"\", \"true\", \"false\"), old-routes: any # Enter if old (deleted) routes should be returned in the response. (Acceptable values are: \"\", \"true\", \"false\")}\n@returns(200)\n\n@endgroup\n\n@end\n"}