Lufthansa

opencollection: 1.0.0
info:
  name: Lufthansa LH Public API
  version: '1.0'
items:
- info:
    name: Reference Data
    type: folder
  items:
  - info:
      name: Lufthansa Countries
      type: http
    http:
      method: GET
      url: https://api.lufthansa.com/v1/references/countries/:countryCode
      headers:
      - name: Accept
        value: ''
      params:
      - name: countryCode
        value: ''
        type: path
        description: 2-letter ISO 3166-1 country code
      - name: lang
        value: ''
        type: query
        description: 2 letter ISO 3166-1 language code
      - name: limit
        value: ''
        type: query
        description: Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is
          given, 100 will be taken)
      - name: offset
        value: ''
        type: query
        description: Number of records skipped. Defaults to 0
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://api.lufthansa.com/v1/oauth/token
        accessTokenUrl: https://api.lufthansa.com/v1/oauth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: List all countries or one specific country. It is possible to request the response in a specific language.
  - info:
      name: Lufthansa Cities
      type: http
    http:
      method: GET
      url: https://api.lufthansa.com/v1/references/cities/:cityCode
      headers:
      - name: Accept
        value: ''
      params:
      - name: cityCode
        value: ''
        type: path
        description: 3-letter IATA city code
      - name: lang
        value: ''
        type: query
        description: 2 letter ISO 3166-1 language code
      - name: limit
        value: ''
        type: query
        description: Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is
          given, 100 will be taken)
      - name: offset
        value: ''
        type: query
        description: Number of records skipped. Defaults to 0
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://api.lufthansa.com/v1/oauth/token
        accessTokenUrl: https://api.lufthansa.com/v1/oauth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: List all cities or one specific city. It is possible to request the response in a specific language.
  - info:
      name: Lufthansa Airports
      type: http
    http:
      method: GET
      url: https://api.lufthansa.com/v1/references/airports/:airportCode
      headers:
      - name: Accept
        value: ''
      params:
      - name: airportCode
        value: ''
        type: path
        description: 3-letter IATA airport code
      - name: lang
        value: ''
        type: query
        description: 2-letter ISO 3166-1 language code
      - name: limit
        value: ''
        type: query
        description: Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is
          given, 100 will be taken)
      - name: offset
        value: ''
        type: query
        description: Number of records skipped. Defaults to 0
      - name: LHoperated
        value: ''
        type: query
        description: Restrict the results to locations with flights operated by LH (false=0, true=1)
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://api.lufthansa.com/v1/oauth/token
        accessTokenUrl: https://api.lufthansa.com/v1/oauth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: List all airports or one specific airport. All airports response is very large. It is possible to request the response
      in a specific language.
  - info:
      name: Lufthansa Nearest Airports
      type: http
    http:
      method: GET
      url: https://api.lufthansa.com/v1/references/airports/nearest/:latitude,:longitude
      headers:
      - name: Accept
        value: ''
      params:
      - name: latitude
        value: ''
        type: path
        description: Latitude in decimal format to at most 3 decimal places
      - name: longitude
        value: ''
        type: path
        description: Longitude in decimal format to at most 3 decimal places
      - name: lang
        value: ''
        type: query
        description: 2 letter ISO 3166-1 language code
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://api.lufthansa.com/v1/oauth/token
        accessTokenUrl: https://api.lufthansa.com/v1/oauth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: List the 5 closest airports to the given latitude and longitude, irrespective of the radius of the reference point.
  - info:
      name: Lufthansa Airlines
      type: http
    http:
      method: GET
      url: https://api.lufthansa.com/v1/references/airlines/:airlineCode
      headers:
      - name: Accept
        value: ''
      params:
      - name: airlineCode
        value: ''
        type: path
        description: 2-character IATA airline/carrier code
      - name: limit
        value: ''
        type: query
        description: Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is
          given, 100 will be taken)
      - name: offset
        value: ''
        type: query
        description: Number of records skipped. Defaults to 0
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://api.lufthansa.com/v1/oauth/token
        accessTokenUrl: https://api.lufthansa.com/v1/oauth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: List all airlines or one specific airline.
  - info:
      name: Lufthansa Aircraft
      type: http
    http:
      method: GET
      url: https://api.lufthansa.com/v1/references/aircraft/:aircraftCode
      headers:
      - name: Accept
        value: ''
      params:
      - name: aircraftCode
        value: ''
        type: path
        description: 3-character IATA aircraft code
      - name: limit
        value: ''
        type: query
        description: Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is
          given, 100 will be taken)
      - name: offset
        value: ''
        type: query
        description: Number of records skipped. Defaults to 0
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://api.lufthansa.com/v1/oauth/token
        accessTokenUrl: https://api.lufthansa.com/v1/oauth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: List all aircraft types or one specific aircraft type.
- info:
    name: Offers
    type: folder
  items:
  - info:
      name: Lufthansa Seat Maps
      type: http
    http:
      method: GET
      url: https://api.lufthansa.com/v1/offers/seatmaps/:flightNumber/:origin/:destination/:date/:cabinClass
      headers:
      - name: Accept
        value: ''
      params:
      - name: flightNumber
        value: ''
        type: path
        description: Flight number including carrier code and any suffix (e.g. 'LH2037')
      - name: origin
        value: ''
        type: path
        description: Departure airport. 3-letter IATA airport code (e.g. 'TXL')
      - name: destination
        value: ''
        type: path
        description: Destination airport. 3-letter IATA airport code (e.g. 'MUC')
      - name: date
        value: ''
        type: path
        description: Departure date (YYYY-MM-DD)
      - name: cabinClass
        value: ''
        type: path
        description: 'Cabin class: ''M'', ''E'', ''C'', ''F''. Some flights have fewer classes (Acceptable values are: "M",
          "E", "C", "F")'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://api.lufthansa.com/v1/oauth/token
        accessTokenUrl: https://api.lufthansa.com/v1/oauth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Cabin layout and seat characteristics.
  - info:
      name: Lufthansa Lounges
      type: http
    http:
      method: GET
      url: https://api.lufthansa.com/v1/offers/lounges/:location
      headers:
      - name: Accept
        value: ''
      params:
      - name: location
        value: ''
        type: path
        description: 3-leter IATA airport or city code (e.g. 'ZRH')
      - name: cabinClass
        value: ''
        type: query
        description: 'Cabin class: ''M'', ''E'', ''C'', ''F'' (Acceptable values are: "", "M", "E", "C", "F")'
      - name: tierCode
        value: ''
        type: query
        description: 'Frequent flyer level (''FTL'', ''SGC'', ''SEN'', ''HON'') (Acceptable values are: "", "FTL", "SGC",
          "SEN", "HON")'
      - name: lang
        value: ''
        type: query
        description: Language code.
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://api.lufthansa.com/v1/oauth/token
        accessTokenUrl: https://api.lufthansa.com/v1/oauth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Lounge information
- info:
    name: Operations
    type: folder
  items:
  - info:
      name: Lufthansa Flight Status
      type: http
    http:
      method: GET
      url: https://api.lufthansa.com/v1/operations/flightstatus/:flightNumber/:date
      headers:
      - name: Accept
        value: ''
      params:
      - name: flightNumber
        value: ''
        type: path
        description: Flight number including carrier code and any suffix (e.g. 'LH400')
      - name: date
        value: ''
        type: path
        description: The departure date (YYYY-MM-DD) in the local time of the departure airport
      - name: limit
        value: ''
        type: query
        description: Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is
          given, 100 will be taken)
      - name: offset
        value: ''
        type: query
        description: Number of records skipped. Defaults to 0
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://api.lufthansa.com/v1/oauth/token
        accessTokenUrl: https://api.lufthansa.com/v1/oauth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Status of a particular flight (boarding, delayed, etc.).
  - info:
      name: Lufthansa Flight Status by Route
      type: http
    http:
      method: GET
      url: https://api.lufthansa.com/v1/operations/flightstatus/route/:origin/:destination/:date
      headers:
      - name: Accept
        value: ''
      params:
      - name: origin
        value: ''
        type: path
        description: 3-letter IATA airport (e.g. 'FRA')
      - name: destination
        value: ''
        type: path
        description: 3-letter IATA airport code (e.g. 'JFK')
      - name: date
        value: ''
        type: path
        description: Departure date (YYYY-MM-DD) in local time of departure airport
      - name: limit
        value: ''
        type: query
        description: Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is
          given, 100 will be taken)
      - name: offset
        value: ''
        type: query
        description: Number of records skipped. Defaults to 0
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://api.lufthansa.com/v1/oauth/token
        accessTokenUrl: https://api.lufthansa.com/v1/oauth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Status of flights between a given origin and destination on a given date.
  - info:
      name: Lufthansa Flight Status at Arrival Airport
      type: http
    http:
      method: GET
      url: https://api.lufthansa.com/v1/operations/flightstatus/arrivals/:airportCode/:fromDateTime
      headers:
      - name: Accept
        value: ''
      params:
      - name: airportCode
        value: ''
        type: path
        description: 3-letter IATA aiport code (e.g. 'ZRH')
      - name: fromDateTime
        value: ''
        type: path
        description: Start of time range in local time of arrival airport (YYYY-MM-DDTHH:mm)
      - name: limit
        value: ''
        type: query
        description: Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is
          given, 100 will be taken)
      - name: offset
        value: ''
        type: query
        description: Number of records skipped. Defaults to 0
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://api.lufthansa.com/v1/oauth/token
        accessTokenUrl: https://api.lufthansa.com/v1/oauth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Status of all arrivals at a given airport up to 4 hours from the provided date time.
  - info:
      name: Lufthansa Flight Status at Departure Airport
      type: http
    http:
      method: GET
      url: https://api.lufthansa.com/v1/operations/flightstatus/departures/:airportCode/:fromDateTime
      headers:
      - name: Accept
        value: ''
      params:
      - name: airportCode
        value: ''
        type: path
        description: Departure airport. 3-letter IATA airport code (e.g. 'HAM')
      - name: fromDateTime
        value: ''
        type: path
        description: Start of time range in local time of departure airport (YYYY-MM-DDTHH:mm)
      - name: limit
        value: ''
        type: query
        description: Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is
          given, 100 will be taken)
      - name: offset
        value: ''
        type: query
        description: Number of records skipped. Defaults to 0
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://api.lufthansa.com/v1/oauth/token
        accessTokenUrl: https://api.lufthansa.com/v1/oauth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Status of all departures from a given airport up to 4 hours from the provided date time.
  - info:
      name: Lufthansa Flight Schedules
      type: http
    http:
      method: GET
      url: https://api.lufthansa.com/v1/operations/schedules/:origin/:destination/:fromDateTime
      headers:
      - name: Accept
        value: ''
      params:
      - name: origin
        value: ''
        type: path
        description: Departure airport. 3-letter IATA airport code (e.g. 'ZRH')
      - name: destination
        value: ''
        type: path
        description: Destination airport. 3-letter IATA airport code (e.g. 'FRA')
      - name: fromDateTime
        value: ''
        type: path
        description: Local departure date and optionally departure time (YYYY-MM-DD or YYYY-MM-DDTHH:mm). When not provided,
          time is assumed to be 00:01
      - name: directFlights
        value: ''
        type: query
        description: Show only direct flights (false=0, true=1). Default is false
      - name: limit
        value: ''
        type: query
        description: Number of records returned per request. Defaults to 20, maximum is 100 (if a value bigger than 100 is
          given, 100 will be taken)
      - name: offset
        value: ''
        type: query
        description: Number of records skipped. Defaults to 0
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://api.lufthansa.com/v1/oauth/token
        accessTokenUrl: https://api.lufthansa.com/v1/oauth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Scheduled flights between given airports on a given date.
- info:
    name: Cargo
    type: folder
  items:
  - info:
      name: Lufthansa Shipment Tracking
      type: http
    http:
      method: GET
      url: https://api.lufthansa.com/v1/cargo/shipmentTracking/:aWBPrefix-:aWBNumber
      headers:
      - name: Accept
        value: ''
      params:
      - name: aWBPrefix
        value: ''
        type: path
        description: 'aWBPrefix : Represents the airline that is the owner of this AWB, i.e. "020" = Lufthansa Cargo, format
          : [0-9]{3} e.g. 020'
      - name: aWBNumber
        value: ''
        type: path
        description: 'aWBNumber : The Air Waybill Number , format : [0-9]{8} e.g. 08002050'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://api.lufthansa.com/v1/oauth/token
        accessTokenUrl: https://api.lufthansa.com/v1/oauth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: With this tracking service you can easily retrieve your shipment or flight status information.
  - info:
      name: Lufthansa Retrieve all flights
      type: http
    http:
      method: GET
      url: https://api.lufthansa.com/v1/cargo/getRoute/:origin-:destination/:fromDate/:productCode
      headers:
      - name: Accept
        value: ''
      params:
      - name: origin
        value: ''
        type: path
        description: 'Departure Airport : 3-letter IATA airport code, e.g. FRA.'
      - name: destination
        value: ''
        type: path
        description: 'Arrival airport : 3-letter IATA airport code, e.g. HKG.'
      - name: fromDate
        value: ''
        type: path
        description: 'Departure date in the local time of the departure airport. Based on LAT (Latest Acceptance Time). format
          : yyyy-MM-dd eg : 2017-07-15'
      - name: productCode
        value: ''
        type: path
        description: 'Product code for requested service and specials : 3-letter eg: YNZ'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://api.lufthansa.com/v1/oauth/token
        accessTokenUrl: https://api.lufthansa.com/v1/oauth/token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: Retrieve a list of all possible flights (both direct and connecting) between two airports on a given date. Routes
      are available for today and up to days in the future.
bundled: true