Key Principles

Overview

Clarity NDC APIs work on a few key principles for enhancing the air-travel experience. We offer:

  • One-way direct flights
  • One-way indirect flights
  • Return direct flights
  • Return indirect flights
  • Multicity direct flights

You have options to choose and book your air-ticket with a dynamic search of flights that suits your requirement. To book the tickets, you need to enter the request payload with the origin, destination, passenger information, and trip type details. The request payload, in response, returns with values, such as Shopping response ID, Offer ID, and Passenger ID. You will need these details for any order change or ticket cancellation. For any change in order from the airlines, you will get an Order Change Notification (OCN). You can accept or cancel the OCN as per your requirement.

One-way direct flights

One-way direct flights take you from the origin airport to the destination airport without any stop along the way. In this option, the return tickets are not booked. We have received an offer request for two customers who wish to fly from Toronto (YTO) to Los Angeles (LAX) on 2nd August. Clarity NDC sends the search to a number of airlines, and Air Canada responds with a price of $430. There is a direct flight from Lester B. Pearson International Airport (YYZ) to Los Angeles International Airport (LAX).

One-way indirect flights

One-way indirect flights take you from the origin airport to the destination airport with one or more stops along the way. In this option the return tickets are not booked. We have received another request for two customers who wish to fly from Toronto (YTO) to Los Angeles (LAX) on 2nd August. Clarity NDC sends the search to a number of airlines, and Air Canada responds with a price of $450. We have two sections inside the offer:

  • Lester B. Pearson International Airport (YYZ) to Vancouver International Airport (YVR), travelling on AC|117, departing at 06:30 AM on 2nd August.
  • YVR to LAX, travelling on AC|558, departing at 07:30 AM local time on 2nd August.

Return direct flights

A return direct flight takes you from the origin airport to the destination airport and then back to the origin airport without any stops along the way. We have received another offer request for two customers who wish to fly from Toronto (YTO) to Los Angeles (LAX) on 2nd August and return on 9th August. Clarity NDC sends the search to a number of airlines, and Air Canada responds with a price of $900. There are direct flights between Lester B. Pearson International Airport (YYZ) and Los Angeles International Airport (LAX).

Return indirect flights

A return indirect flight takes you from the origin airport to the destination airport and then back to the origin airport with one or more stops along the way. We have received another request for two customers who wish to fly from Toronto (YTO) to Los Angeles (LAX) on 2nd August and return on 9th August. Clarity NDC sends the search to a number of airlines, and Air Canada responds with a price of $990. We have two sections inside the offer:

  • Lester B. Pearson International Airport (YYZ) to Vancouver International Airport (YVR), travelling on AC|117, departing at 06:30 AM on 2nd August and YVR to LAX, travelling on AC|558, departing at 07:30 AM local time on 2nd August.
  • LAX to YVR travelling on AC|559, departing at 5:30 AM on 9th August and YVR to YYZ travelling on AC|126 at 10:30 PM local time on 9th August.

Multicity direct flights

A multicity flight combines flights between several cities into one booking. This type of flight saves the time of booking several one-way tickets. Once you choose this option, you just need to keep adding flights and dates until your trip is complete. We received a request for a multi-city trip from Dubai (DXB) to Bangkok (BKK) and Bangkok (BKK) to Singapore (SIN). The flight from Dubai (DXB) to Bangkok (BKK) is required on 29th July and from Bangkok (BKK) to Singapore (SIN) on 2nd August. Clarity NDC sends the search to a number of airlines, and gets an offer for $890 per person. This offer contains three segments:

  • DXB to BKK, travelling on an Emirates flight, EK|384, departing at 05:30 AM on 29th July.
  • BKK to Hong Kong (HKG), travelling on a Emirates flight, EK|384, departing at 05:00 AM on 2nd August.
  • HKG to SIN, travelling on a Cathay Pacific Airlines flight, CX|691, departing at 08:30 PM on 3rd August.