Exchange Search API Reference

POST

exchangesearch/catalogofferingsairchange

Base path:

Note the following base path varies from that used for other JSON APIs.

Pre-production https://api.pp.travelport.com/11/

Production https://api.travelport.com/11/

Related Content: GDS Exchanges Guide, Ticketing Exchange Guide & API Reference

The Exchange Search API is the second step in the GDS exchange workflow, after the optional Eligibility step. It searches for an alternate itinerary for a possible exchange on a currently ticketed GDS itinerary. The response details any differences in base fare, taxes, fees, and total price between the currently ticketed itinerary and the possible new itinerary. It should be followed by an Add/Modify Offer request to select a new itinerary from these search results.

Exchange Search supports exchanges for multiple travelers, and for itineraries with multiple offers, as follows:

  • You can send a single Exchange Search request for multiple passengers.

  • You must send a separate Exchange Search request for each offer to exchange: Use one workbench session for one leg of the change, and another workbench session for the next leg of the exchange.

GDS only. For NDC exchange functionality, see the NDC Modify, Cancel, and Exchange Guide.

Request

Query Parameters

None.

Request Body

See the Exchange Search Overview in the GDS Exchanges Guide for important information about requirements for exchanges.

Response

The Exchange Search response is similar to the Search response. The table below refers to the response table in the Search API Reference for several common objects that are returned in the Exchange Search response with the same type of data.

Example Request

For additional examples and scenarios, download the developer toolkits and see Using Postman and Developer Toolkits.

The example below requests an Exchange Search for multiple passengers.

Example Response

For additional examples and scenarios, download the developer toolkits and see Using Postman and Developer Toolkits.

For brevity, the following example has been edited to remove several instances of individual offers, terms and conditions, and flights. Because of that editing offers may return flights not shown in ReferenceList and vice versa.