Introduction
British Airways offers industry leading selling capabilities via its NDC APIs. This page will provide an overview about all capabilities and supported functionality. Associated API flows are below for each function. Each API should be called in turn passing details taken from the previous call into the next API call, details can be found on the individual API call details pages.
Supported fare products
- Published Fares
- Corporate Fares
- Tour Operator Deferred
- Tour Operator Semi-Deferred
- Contract Bulk
- Private Fare Adult
- Marine
- Humanitarian
NDC offer storage overview
In British Airways NDC APIs, we offer to ways to shop for offers:
The preferred approach to shop for offers is by using short sell functionality, information of which can be found below:
Instant purchase payment options
We accept the following form of payments via our NDC API's
- Debit Cards
- Credit Cards
- IATA BSP Special Cash
- ARC Special Cash
- 3D Secure 1.0
- 3D Secure 2.0
- E-Vouchers for flights
- Residual Value Vouchers for flights
Information to help make better choices
Fare Labels for Leisure Fares / Negotiated and Non-Negotiated fares
Agents are able to shop for Offers based on Fare type preference (Negotiated, Non-Negotiated, Leisure) by passing it in the AirShopping request. AirShopping will return Offers based on the Fare type requested, if available for the Agent. Agents then make a booking by choosing an appropriate Fare returned in Offer.
Change and Cancellation Fare Rules
BA has introduced a new PADIS code, 70G to enable TMCs to uniquely shop for and identify corporate fares. This will be a new way for customers to request corporate fares and will be available in Short Sell of the BA 17.2 APIs only.
Cabin Upsell offer
BA will enable product upsell at offer price within cabin e.g. From a fare without a bag to a fare with a bag. This will be for all agents
Industry Standard Cabin Names
BA will be standardising cabin names across all APIs to make it easier for developers to identify cabins relating to different offers, especially where there are multiple airline carriers.
British Airways NDC Offer Management Overview - Flows
Shop for Flights
The AirShopping API can be called using any combination of the below filters:
- Calendar led pricing
- Shopping by cabin class
- Shopping for cheapest or flexible offers
- Shopping by Departure and Arrival times
- Shopping for direct flights
- Shopping by Ticketing Time Limit
- Shopping by maximum connecting time
- Shopping by aircraft type
- Shop for Negotiated / Non-Negotiated fares or both
- Shop for fares with or without cabin baggage allowance in Economy class
Capability not yet supported:
- Redemption availability
- Non-flight (hotel) availability
- Maximum 6 Origin and Destination can be requested
- Calendar offers are not supported for Origin and Destination greater than two
- Baggage allowance (currently only be supported for all routes operated by BA and codeshare flights).
- Cannot be called for Group availability (more than 9 passengers)
- Cannot be called for Unaccompanied Minor (children travelling alone, up to age 15)
Shop for Flights with Prime Sale Baggage
During prime sale booking flow you can also add additional baggage to any offer using the below API flow:
Shop for Flights with Prime Sale Seating
During prime sale booking flow you can also complete seat selection for both paid and free seating by using the below API flow.
note: paid seats are cheaper during prime sale and will cost more if adding a paid seat to an already created order
note: only can call Seatavailability once as OrderCreate only accepts 1 ResponseId for the selected seats
Shop for Flights with Prime Sale Seating and Additional Baggage
During prime sale booking flow you can also add seating and additional baggage by following the below API flow. Offer details must be selected and passed to OrderCreate.