Working with the cart

Please make sure you read the Conventions before continuing with this guide.


You will need an X-API-KEY and a JWT token to interact with the shopping cart.

Adding an item

Use the /sales/cart endpoint of the Sales Bucket to add items to the shopping cart.

The first call will create a shopping cart and return information about it, including the cartId:

Replace the placeholders in the payload above with information returned by other APIs during the purchase reservation flow.

The passengers array contains a list of passenger information retrieved from the travellers. You will need one passenger entry for each journey that is being travelled.

Note that the passenger's fareClassIds only need to be specified if Fare Classes are in use. Otherwise, this parameter should be left out of the request.

Detailed documentation for this endpoint is available under .