OND

The OND resource provides access to origin and destination airline route information. You can search all existing routes beween cities and coutries or search top routes per market. Additionally, new routes or recently retired routes may be retrieved.

The API provides three related methods

Search Routes

Provides an overview of all available connections between cities and countries.

Request URI

Code snippet: URL

offers/ond/route/{origin}/{destination}
Variable Description Format
{origin} The departure city. 3-letter IATA code, e.g. “FRA”.
{destination} The arrival city. 3-letter IATA code, e.g. "NYC".

Request Examples

Search all connections between an origin city and destination city

offers/ond/route/FRA/NYC

Search all connections between two countries

offers/ond/route/DE/US

Search all connections between an origin city and a destination country

offers/ond/route/FRA/US

Search all connections between an origin country and a destination city

offers/ond/route/US/FRA

Search all connections between an origin country and all destinations

offers/ond/route/US/*

Search Top OND

Search for Top ONDs per country or across all countries. Top ONDs represent routes with the highest ticket sales. The top 10 connections (sorted ramdomly) will be returned.

Request URI

Code snippet: URL

offers/ond/top?origin={country}
Variable Description Format
{country} origin country 2-letter IATA country code, e.g. “de”.

Request Examples

Search top routes from origin country Germany (de)

Code snippet: URL

offers/ond/top?origin=de

Search top routes across all countries (markets)

Code snippet: URL

offers/ond/top

Search Route Status

Search for newly added or recently retired connections. You may search for new only or deleted only or both.

Request URI

Code snippet: URL

offers/ond/status?new-routes=[true|false]&old-routes=[true|false]
Variable Description Format
{new-routes} Fares catalogue to be searched 2-character IATA airline designator code.
{old-routes} The departure airport. 3-letter IATA code, e.g. “FRA”.

Request Examples

Search new routes only

offers/ond/status?new-routes=true

Search old routes only

offers/ond/status?old-routes=true

Search old and new routes

offers/ond/status?new-routes=true&old-routes=true

Note: searching new-routes=false & old-routes=false is not possible

Response Structure Definition

Origin and Destination records are grouped per requested carrier.

Key Description
getONDResponse Root element of the OND response.
.ONDResponse Contains OND message response.
..Carriers Groups the OND data by Carrier.
...Carrier Carrier for which the OND data applies
...Code Carrier IATA two letter code
....ONDList Holds all OND records
.....OND Holds information related to one specific OND record
......Origin Origin city
......OriginCountrCode Origin country
......Destination Destination city
......DestinationCountryCode Destination country
......NewONDIndicator Indicates if the record is new (can be 'true' or 'false')
......DeletedONDIndicator Indicates if the record has been deleted (can be 'true' or 'false)
......TopONDIndicator Indicates if the OND is a Top OND
.Meta Element containing meta data
..Version version number
..Link Element specifying links
...Href link to actual resource
...Rel Specifying kind of link such as ‘self’ (link that returned this response), ‘alternate’ (link that points to another resource) or ‘related’ (link that points to related resource).

Response Example

<?xml version="1.0" encoding="UTF-8"?>
<getONDResponse>
  <ONDResponse>
    <Carriers>
      <Carrier code="LH">
        <ONDList>
          <OND>
            <Origin>ZRH</Origin>
            <OriginCountryCode>CH</OriginCountryCode>
            <Destination>FRA</Destination>
            <DestinationCountryCode>DE</DestinationCountryCode>
            <NewONDIndicator>False</NewONDIndicator>
            <DeletedONDIndicator>False</DeletedONDIndicator>
            <TopONDIndicator>False</TopONDIndicator>
          </OND>
        </ONDList>
      </Carrier>
    </Carriers>
  </ONDResponse>
  <Meta Version="1.0.0">
    <Link Href="https://api-test.lufthansa.com/ond_v1.0.0/route/ZRH/FRA" Rel="self"/>
  </Meta>
</getONDResponse>