Seat Map API Reference

POST

search/seat/catalogofferingsancillaries/seatavailabilities

Base path:

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

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

Related Content: Seats Guide, Seat Book API Reference

The Seat Map request returns seat availability for both free and paid seats.

You can request seat availability at several places in the JSON APIs workflow: after Search, after AirPrice, or as part of either an initial or post-commit workbench session. See the workflow options in the Seats Guide. To select a seat, you must send a Seat Book request in a workbench session to add the selected seat/s to the workbench.

The Seat Map request uses the same endpoint but a different message payload depending on when it is sent.

All Seat Map requests allow you to request seat maps for any of the following:

  • all flights within an offer (all flights on the itinerary)
  • all flights within a product (all flights on one leg of an itinerary)
  • one or more individual flights. You request a flight by its segment sequence number within the itinerary. You can send multiple segment sequences.
Seat map support varies for NDC and GDS, specific carriers, and at places in the booking workflow, See the Seats Guide for support details.

Request

Query Parameters

None.

Request Body – Seat Map after Search request

Seats 23.11.5 and later only.

When sent after a Search request and prior to pricing or initiating a workbench session, the Seat Map request sends identifiers from the Search response. You can request seat maps for a flight, product, or segment returned in any Search, Next Leg Search, or Flight Specific Search response.

Request Body – Seat Map during workbench session

When sent during a workbench session, the Seat Map request sends identifiers from the Search response.

Request Body – Seat Map after AirPrice request

When sent after an AirPrice request and prior to initiating a workbench session, the Seat Map request sends identifiers from the AirPrice response.

Response

The seat map response is the same for all Seat Map requests, regardless of where sent in the workflow.

Example Request

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

Example Request after Search, no workbench

You can request seat maps after any Search, Next Leg Search, or Flight Specific Search response without establishing a workbench. You can request seat maps for the entire itinerary (the offer), all flights on one leg (the product), or a single flight (the segment). The following example requests seat maps for all flights on product p0, which is one leg of the itinerary.

Example Request after AirPrice, no workbench

A seat map request following an AirPrice request also supports requesting seat maps for all flights either in the offer, the product, or segment. The following example requests a seat map for only segment 1 in product p0.

Example Request in workbench

When sent during either an initial or post-commit workbench session, the Seat Map request can return seat maps for either all flights in the offer, the product (one leg), or by segment (one flight) for both GDS and NDC.

The following example sends only the offer identifier. This returns seat maps for all flights in the itinerary.

The following example requests a seat map for two products. This returns seat maps for all flights on those products. In the JSON APIs, a product is one leg of an itinerary.

The following example requests a seat map for the first segment in the requested product on an NDC itinerary. This returns seat maps for the first flight on the leg specified by that product ID.

Example Response

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

The seat map response is the same regardless of whether the request was sent after Search, after AirPrice, or in a workbench session.

The following complete example of a GDS seat map response returns the seat map for a single flight, which offers only free seats, indicated by the single instance of CatalogOffering with a Price/TotalPrice value of 0.

The following seat map response for NDC returns both free seats (price of 0) and paid seats (price of 60), each in a separate instance of CatalogOffering.