Reference · step 5 of 9
POST/flights/seat-map
{{base_url}}/flights/seat-map
Optional. The seat map of every flight of the itinerary with price and availability per seat.
Headers
| Content-Type | application/json |
| Authorization | Bearer {{token}} |
Reply (1 notes)
- segments[] as in ancillaries; each seats block names its flight by (journey_index, segment_index). desc is the seat label (1A) that goes into the booking; code is the seat type.
Keys and what they mean
Request
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| itinerary_id | string | required | must read | The itinerary_id from reprice. |
| Total: 1 keys | ||||
Reply
| key | type | when present | importance | meaning |
|---|---|---|---|---|
| segments[] | array | always | useful | The flights of the itinerary, each named by (journey_index, segment_index), with airline_code, flight_number, from and to. |
| seats[] | array | always (empty when the airline gives no map) | must read | One seat map per flight: journey_index, segment_index, aircraft_type, total_seats and seats. |
| seats[].seats[] | array | always | must read | Every seat: code (send it to book), desc (e.g. 3A, show it), row, column, amount (price; 0 = free), tax, is_available. |
| seats[].seats[].window / aisle / middle | boolean | always | useful | Where the seat is in its row. |
| seats[].seats[].exit_row / leg_room / infant / near_wings / reclining | boolean | always | useful | Seat features. A passenger with an infant needs a seat with infant true; exit rows have rules of their own. |
| Total: 5 keys | ||||
Errors this call answers with (4)
| HTTP | code | message | detail | when |
|---|---|---|---|---|
| 401 | 9001 | Authentication required | Invalid token | |
| 400 | 5100 | Invalid search request | itinerary_id is required | |
| 404 | 5104 | Itinerary not found or expired | ||
| 502 | 5001 | The airline or supplier could not complete the request |
Real captures of this call
- Domestic, one way, 1 adult · HTTP 200 · reply in the viewer
- Domestic, one way, 1 adult, 1 child, 1 infant · HTTP 200 · reply in the viewer
- Domestic, return, 1 adult · HTTP 200 · reply in the viewer
- Domestic, return, 1 adult, 1 child, 1 infant · HTTP 200 · reply in the viewer
- International, one way, 1 adult · HTTP 200 · reply in the viewer
- International, one way, 1 adult, 1 child, 1 infant · HTTP 200 · reply in the viewer
- International, return, 1 adult · HTTP 200 · reply in the viewer
- International, return, 1 adult, 1 child, 1 infant · HTTP 200 · reply in the viewer
- Seat map with paid and free seats · HTTP 200 · reply in the viewer
- Book on hold with a seat, a meal and a bag, one flight · HTTP 200 · reply in the viewer
- Book on hold with ancillaries on a two-flight journey · HTTP 200 · reply in the viewer
- Direct booking (paid, no hold) with a seat, a meal and a bag, one flight · HTTP 200 · reply in the viewer
- Direct booking (paid, no hold) with ancillaries on a two-flight journey · HTTP 200 · reply in the viewer