• Register

Air Shopping

Click here for full AirShopping Technical Specification

The Air Shopping API returns flight product prices for requested origin and destination, cabin and date. Provides the cheapest available offer and higher classes of service together with their product descriptions.

The service uses IATA NDC AirShoppingRQ & RS v16.1 schemas

Although the Air Shopping API is stateless, it is recommended (and assumed) that it will be called as part of the following sequence of Shop and Order APIs

  1. AirShopping
  2. FlightPrice
  3. SeatAvailability (where advance seat selection is requested)
  4. OrderCreate

Version Information

The most recent version of the Air Shopping API is version 2. Previous versions are shown below.

BA Version IATA Version Status End-of-life date
v01 1.1.3 Still supported To be confirmed
v02 16.1 Current Version n/a

API Endpoints

Air Shopping has a SOAP API endpoint.

The endpoints available are:

Endpoint URL
Live https://api.ba.com/selling-distribution/AirShopping/V2
Test https://test.api.ba.com/selling-distribution/AirShopping/V2

API Methods

Method URL Resource Description
POST /selling-distribution/AirShopping/V2 returns priced availability

HTTP Headers

Header Name Description Mandatory? Example
client-key Your unique key used to authorise access to the API. Yes n/a

Request parameters

To view the request parameters for the AirShopping requests, please view the full technical specification.

WSDL

Click here to view the AirShopping WSDL.

Response elements

The following error codes may be returned by the service

AirShoppingRS/InfoGroup/Error/Code Meaning Description
1 Error Invalid date
304 Error System Temporarily unavailable
421 Error "Not Available and Waitlist is Closed" - sent when one or more of the flights is not available

Supported Status Codes

You can view the standard status codes returned by our APIs here.