Guides

Seat maps

Show the seat layout and assign seats
View as Markdown

Call OTA_AirSeatMapRQ to get the seat map for a segment. Use it to show travelers the layout, see which seats are free, and pick seats. To put a passenger in a seat, you send a seat change on the booking.

Seat changes apply to issued tickets only

Seat changes apply only to issued tickets. Once payment is complete and passenger information is set, the ticket is issued and you can assign or change seats.

Get the map

Reference the booking by its W1 record locator for an issued ticket booking, and describe the segment you want the map for.

1{
2  "version": "2.001",
3  "pos": {
4    "source": [
5      {
6        "isoCurrency": "SAR",
7        "requestorID": { "id": "AGENT001", "name": "Sample Travel", "type": "5" },
8        "bookingChannel": { "type": "OTA" }
9      }
10    ]
11  },
12  "bookingReferenceID": [
13    { "companyName": { "code": "W1" }, "type": "14", "id": "N6G2NW" }
14  ],
15  "seatMapRequests": {
16    "seatMapRequest": [
17      {
18        "flightSegmentInfo": {
19          "departureAirport": { "locationCode": "JXD" },
20          "arrivalAirport": { "locationCode": "MKX" },
21          "operatingAirline": { "code": "HHR", "flightNumber": "0141" },
22          "departureDateTime": "2026-05-20T17:21:00.000+03:00"
23        },
24        "travelerRefNumberRPHs": ["1"]
25      }
26    ]
27  }
28}

Read the map

The response returns the cabin, its rows, and the seats in each row. Every seat carries a number, its availability, and its features.

1{
2  "success": {},
3  "seatMapResponse": [
4    {
5      "seatMapDetails": [
6        {
7          "cabinClass": [
8            {
9              "zone": { "code": "006", "totalSeatQty": 38 },
10              "rowInfo": [
11                {
12                  "seatInfo": [
13                    {
14                      "summary": { "seatNumber": "142", "rowNumber": 2, "columnNumber": 4 },
15                      "availability": { "value": "SEAT_OCCUPIED" },
16                      "features": [{ "value": "WINDOW" }],
17                      "status": [{ "value": "BOOKED" }]
18                    },
19                    {
20                      "summary": { "seatNumber": "143", "rowNumber": 2, "columnNumber": 5 },
21                      "availability": { "value": "SEAT_AVAILABLE" },
22                      "features": [{ "value": "AISLE" }],
23                      "status": [{ "value": "FREE" }]
24                    }
25                  ]
26                }
27              ]
28            }
29          ]
30        }
31      ]
32    }
33  ]
34}

A seat with availability of SEAT_AVAILABLE is free to take. features tells you whether it is a window or aisle seat.

Assign a seat

Picking a seat is a change to the booking, not part of the seat map call. Send an OTA_AirBookModifyRQ with modificationType 5 for the passenger and the seat you chose. Seats can be changed even after the booking is paid. See Updating passengers.

For the exact seat-change body, see the GO7 seat map and modify-booking pages.