NDC Workflow

This page describes the typical workflow when using the NDC Gateway API. The NDC standard organizes operations into three categories: Shopping, Selling, and Servicing.

Overview

The NDC standard organizes operations into three categories: Shopping (search and browse), Selling (price and book), and Servicing (retrieve and modify). The diagram below shows how these operations combine in practice.

Service flows

The following diagram shows the four main booking scenarios and how the NDC operations combine depending on what you need to book:

Each column represents a different use case — from a simple flight booking to a full booking with ancillary services and seat selection. The bottom section shows the post-booking confirmation flow, including the retry mechanism with OrderRetrieve (up to 3 attempts) and the fallback to OrderReshop if payment or segment confirmation fails.

Step-by-step booking flow

1. Search for flights — AirShopping

Search for available flights by providing origin, destination, dates, and passenger details. The response contains a list of offers with flight options and pricing.

• Endpoint: POST /x3/ndc/api/Shopping/r3.x/v21.3/AirShopping
• What you get: Flight offers with schedules, fare details, and offer IDs.
• Next step: Pick an offer and confirm its price.

2. Confirm pricing — OfferPrice

Before creating a booking, confirm the price of the selected offer. Prices may change between search and booking, so this step ensures you have the latest fare.

• Endpoint: POST /x3/ndc/api/Selling/r3.x/v21.3/OfferPrice
• Input: The offer ID from the AirShopping response.
• What you get: Confirmed pricing, fare conditions, and the offer details needed to create an order.

3. Create the booking — OrderCreate

Create a booking (order) by providing passenger details and the confirmed offer.

Before creating the order, you may optionally request available ancillary services (ServiceList) or seat maps (SeatAvailability) using the offer ID, allowing you to include them in the booking from the start.

• Endpoint: POST /x3/ndc/api/Selling/r3.x/v21.3/OrderCreate
• Input: Passenger information (names, contact details) and the priced offer.
• What you get: An order ID (booking reference) and the full booking details.

4. Browse available services — ServiceList (optional)

Retrieve the list of ancillary services available for the booking, such as extra baggage, meals, or priority boarding.

• Endpoint: POST /x3/ndc/api/Selling/r3.x/v21.3/ServiceList
• Input: The order ID.
• What you get: Available services with descriptions and pricing.

5. Select seats — SeatAvailability (optional)

Check seat availability and select seats for the passengers in the booking.

• Endpoint: POST /x3/ndc/api/Selling/r3.x/v21.3/SeatAvailability
• Input: The order ID.
• What you get: Seat map with available seats and pricing.

6. Modify the booking — OrderChange (optional)

Add services, assign seats, or make other changes to an existing booking.

• Endpoint: POST /x3/ndc/api/Servicing/r3.x/v21.3/OrderChange
• Input: The order ID and the requested changes.
• What you get: Updated booking details.

Other operations

API versions

The NDC Gateway supports two API versions for each endpoint:

Both versions are available for all operations. The v21.3 endpoints follow the IATA NDC standard. The v2 (DAPI) endpoints use Navitaire's Digital API format.

Next steps

• See the Get Started page for environment URLs and authentication details.
• See the Reference documentation for the full request and response schemas.
• Download the Postman Collection to try the workflow interactively.