Skip to navigation

Get the seat map

View as Markdown

Get the seat map for one or more segments of a paid booking so you can show the layout and let the traveler pick a seat. Read the booking with OTA_ReadRQ first and reuse its segment as flightSegmentInfo, its travelers as airTravelers, and its W1 locator in bookingReferenceID. Name the travelers you want a map for in travelerRefNumberRPHs.

The response returns one seatMapResponse per segment. Each coach (cabinClass) carries a flat availabilityList and a full rowInfo grid. A seat whose availability is SEAT_AVAILABLE is free; SEAT_OCCUPIED is taken by someone else; SEAT_RESERVED is held by the passenger you asked about.

Seat maps are available only after the booking is paid and before its updateTravellersTimeLimit, and not for a segment that has departed or been cancelled. Outside that window the API answers CHANGES_ARE_NOT_PERMITTED. To move a passenger to a seat, send an OTA_AirBookModifyRQ with modificationType 5.

Headers

x-api-keystringRequired
local-nameenumRequiredDefaults to OTA_AirSeatMapRQ
Routes the request to the seat map operation.
Allowed values:

Request

This endpoint expects an object.
posobjectRequired
Point of sale. Identifies the agent and channel behind the request.
versionstringRequired
seatMapRequestsobjectRequired
bookingReferenceIDlist of objectsRequired
The booking's W1 record locator.
airTravelersobjectOptional

The booking’s travelers, as OTA_ReadRQ returned them.

Response

The seat map for each requested segment.
seatMapResponsesobjectOptional