Skip Navigation

Stateless Ancillaries API

Air
Ancillaries
REST API
Airline Carrier

If you are interested in using Digital Connect Stateless APIs, please reach out to your account director.

What is it?

Stateless Ancillaries API is used to retrieve available ancillary offers by providing a PNR or by offerPayload or by providing passenger and segment information or by offerId. This API also has the ability to add an ancillary required by the airline to a PNR or remove an ancillary from a PNR as well.

Why use it?

Capabilities:

Leveraging this stateless ancillaries service is accompanied by the following capabilities listed below.

  • Shop for ancillaries: Ancillary offers can be retrieved either by providing the PNR in the request for all segments in the PNR or by providing passenger and segment data in the request or by providing offerId or offerPayload which includes segments, passengers, offers, selectedSegments, itinerary and itineraryParts. The passengers can choose the available ancillaries and the details exposed. Ancillary shop response returns ancillary offers, ancillary prices and available discounted offers based on the given passenger data.

  • Add ancillaries: This stateless service is used to add available ancillaries offers to the PNR. The service also supports an option to override the amount of an ancillary. It is required to provide pnrLocator and offer.

  • Remove ancillaries: This service allows a user to remove previously booked ancillary for a particular passenger for a flight segment. Multiple ancillaries if present in a PNR can be removed with a single request. It is required to provide airExtraIds and pnrLocator in order for the ancillary to be deleted from the PNR. airExtraIds are the ids for ancillaryService which can be retrieved by calling PNR display.

How it works

Shop for Ancillaries

Stateless Ancillary Shop Service [endpoint: ancillaries/shop] provides a list of available ancillaries for one or multiple segments and passengers. Ancillary request should provide passenger/s details for associated segments. The service responds with the ancillary offers, prices and other relevant information. Discounts will be returned if applicable.

  • The user creates a request providing information about the desired flight, including the fare basis information, booking class etc. Please visit the reference documentation section for details regarding the contract.

Add Ancillaries

Stateless Ancillary Add Service [endpoint: ancillaries/add] allows the user to book one or more ancillaries for passenger/s for a specific segment/itinerary, in addition the user may apply ancillary price override. Prior to adding the specified ancillary, the user may call the above service [ancillaries/shop] to obtain a list of available ancillaries with prices. Based on the ancillary service response the user may then call the service ancillaries/add to reserve the specific ancillary for the requested passengers that should be added to the reservation.

  • The user provides information about the ancillary offers, quantity and its reference to the passenger and segment.

Remove Ancillaries

Stateless Ancillary Remove Service [endpoint: ancillaries/remove] allows the user to remove previously booked ancillary for a particular passenger for a flight segment.

  • The user provides information about the airExtraId of an ancillary to be removed from the record.

How to use

Download the postman collection with sample usecase(s) of Stateless Ancillaries service. The collection contains details about setting up and performing operations using stateless services.

Additional information could also be found