---
title: "Get flight seat map"
method: POST
path: "/v2/air/seat-map"
tags: ["Air"]
---

# Get flight seat map

`POST /v2/air/seat-map`

Get seat map for the flights in the given itinerary.

## Request body

- AirSeatMapRequest — Describes the traveler and the itinerary for which the seat map is to be returned.
  - `itinerary` union, required — The itinerary for which the seat map needs to be returned.
    - AirItineraryIdWrapper
      - `airItineraryId` AirItineraryIdentifier — An air itinerary ID wrapper.
        - `searchId` string, required — The search ID associated with the itinerary, returned in the air search response.
        - `itineraryId` string, required — The itinerary ID of the itinerary selected by the user, for which the seat map is requested.
    - PnrItineraryWrapper
      - `pnr` PnrItinerary — The pnr's itinerary for which the seat map needs to be returned.
        - `pnrId` string, required — The PNR ID.
  - `travelerInfos` TravelerSeatInfo[], required — Information about the travelers on the itinerary.
    - `travelerType` 'UNKNOWN_PASSENGER_TYPE' | 'ADULT' | 'CHILD' | 'INFANT' | 'INFANT_ON_LAP' | 'YOUTH' | 'SENIOR' | 'TEEN' — Type of passenger
    - `travelerAge` PassengerAge — Age of the traveler
      - `numYears` integer, required — Age of the passenger
    - `travelerInfo` union — The traveler identifiers. These can be either the Spotnana user IDs of the travelers or information regarding the adhoc travelers.
      - object — Wrapper over UserId object to be used as an identifier in a oneOf case
        - `userId` UserId — User identifier
          - `id` string, uuid, required
      - object — Wrapper over AdhocTravelerInfo object to be used as an identifier in a oneOf case.
        - `adhocTravelerInfo` AdhocTravelerInfo — Describes an adhoc traveler.
          - `registrarUserId` UserId — User identifier
            - `id` string, uuid, required
          - `externalId` string — External Id of user
    - `loyaltyInfos` SeatLoyaltyInfo[] — Information about the traveler's loyalty program memberships.
      - `flightId` string — The flight identifier for which this loyalty is being applied.
      - `loyaltyInfos` LoyaltyInfo[]
        - `appliedTo` string[]
        - `id` string, required
        - `issuedBy` string, required
        - `type` 'UNKNOWN_TYPE' | 'AIR' | 'HOTEL' | 'CAR' | 'RAIL', required
        - `linked` boolean — Indicates if this loyalty account is linked to the external provider. Only applicable for certain loyalty types.
        - `tier` string — Loyalty membership tier name echoed from the supplier.
  - `indexes` SeatIndexes[] — Indexes for the seat map request must be provided only when specific legs or flights need to be selected. If not provided, all legs and flights will be considered.
    - `legIndex` integer, required — The leg index for which the seat map is requested.
    - `flightIndex` integer[] — The flight index for which the seat map is requested. It is optional and if it not present, then all the flights will be returned for this leg

## Response `200`

OK

- AirSeatMapResponse — The overall seat map response for the air seat map request.
  - `seatMapResponseId` string — Unique identifier for this seat map response, which would need to be passed on in subsequent booking APIs.
  - `travelerSeatMaps` TravelerSeatMap[] — Seat maps for a flight for each traveler type.
    - `travelerId` UserId — User identifier
      - `id` string, uuid, required
    - `travelerInfo` union — The traveler identifiers. These can be either the Spotnana user IDs of the travelers or information regarding the adhoc travelers.
      - object — Wrapper over UserId object to be used as an identifier in a oneOf case
        - `userId` UserId — User identifier
          - `id` string, uuid, required
      - object — Wrapper over AdhocTravelerInfo object to be used as an identifier in a oneOf case.
        - `adhocTravelerInfo` AdhocTravelerInfo — Describes an adhoc traveler.
          - `registrarUserId` UserId — User identifier
            - `id` string, uuid, required
          - `externalId` string — External Id of user
    - `flightSeatMapIds` string[] — Seat maps for the specified travelerId. Ids refer to the id in AirSeatMapResponse -> seatMaps.
  - `seatMaps` FlightSeatMap[] — The list of seat maps available in the response.
    - `seatMapId` string — Unique identifier for this flight seat map.
    - `wingRows` Int32Range
      - `min` integer — Minimum value - inclusive.
      - `max` integer — Maximum value - inclusive.
    - `cabinSections` CabinSection[] — Cabin sections available in the flight.
      - `cabin` 'UNKNOWN_CABIN' | 'ECONOMY' | 'PREMIUM_ECONOMY' | 'BUSINESS' | 'FIRST' — Flight cabin
      - `bookingCode` string
      - `locations` SeatLocation[] — The list of locations associated with the cabin section.
      - `facilitySections` FacilitySection[] — The set of associated facility sections.
        - `location` 'FRONT' | 'MIDDLE' | 'REAR' | 'LEFT' | 'LEFT_CENTER' | 'RIGHT' | 'RIGHT_CENTER' | 'CENTER' | 'UPPER_DECK' | 'LOWER_DECK' | 'MAIN_DECK' — Describes a location in the flight.
        - `facilities` Facility[]
          - `location` 'FRONT' | 'MIDDLE' | 'REAR' | 'LEFT' | 'LEFT_CENTER' | 'RIGHT' | 'RIGHT_CENTER' | 'CENTER' | 'UPPER_DECK' | 'LOWER_DECK' | 'MAIN_DECK' — Describes a location in the flight.
          - `facilityType` 'BULKHEAD' | 'STAIRS' | 'TABLE' | 'LAVATORY' | 'BAR' | 'CLOSET' | 'AIR_PHONE' | 'EXIT_DOOR' | 'EMERGENCY_EXIT' | 'GALLEY' | 'LUGGAGE_STORAGE' | 'STORAGE_SPACE' — Facility type is used to represent row facilities and cabin facilities.
      - `columnSections` ColumnSection[] — The columns associated with the cabin section.
        - `columns` Column[]
          - `columnNumber` string
          - `position` 'AISLE' | 'WINDOW' | 'WINDOW_AISLE' | 'CENTER' — Represents the position of a column in a row.
      - `rowSections` RowSection[] — The rows associated with the cabin section.
        - `rowNumbers` Int32Range
          - `min` integer — Minimum value - inclusive.
          - `max` integer — Maximum value - inclusive.
        - `availableSeats` AvailableSeats[] — Available seats for each row in this Row Section.
          - `columnNumber` string[]
        - `rowTypes` RowType[]
        - `facilitySections` FacilitySection[]
          - `location` 'FRONT' | 'MIDDLE' | 'REAR' | 'LEFT' | 'LEFT_CENTER' | 'RIGHT' | 'RIGHT_CENTER' | 'CENTER' | 'UPPER_DECK' | 'LOWER_DECK' | 'MAIN_DECK' — Describes a location in the flight.
          - `facilities` Facility[]
            - `location` 'FRONT' | 'MIDDLE' | 'REAR' | 'LEFT' | 'LEFT_CENTER' | 'RIGHT' | 'RIGHT_CENTER' | 'CENTER' | 'UPPER_DECK' | 'LOWER_DECK' | 'MAIN_DECK' — Describes a location in the flight.
            - `facilityType` 'BULKHEAD' | 'STAIRS' | 'TABLE' | 'LAVATORY' | 'BAR' | 'CLOSET' | 'AIR_PHONE' | 'EXIT_DOOR' | 'EMERGENCY_EXIT' | 'GALLEY' | 'LUGGAGE_STORAGE' | 'STORAGE_SPACE' — Facility type is used to represent row facilities and cabin facilities.
        - `seatSections` SeatSection[]
          - `columnNumbers` string[] — The seat columns present in the seat section.
          - `type` 'SEAT' | 'NO_SEAT' | 'BULKHEAD' | 'STAIRS' | 'LAVATORY' | 'BAR' | 'CLOSET' | 'AIR_PHONE' | 'EXIT_DOOR' | 'EMERGENCY_EXIT' | 'GALLEY' | 'LUGGAGE_STORAGE' | 'STORAGE_SPACE' | 'TABLE'
          - `limitations` string[]
          - `facilities` string[]
          - `location` string[]
          - `commercialName` string — Commercial name for this seat.
          - `price` Price — Price for a seat.
            - `totalAmount` Money — Money object containing details such as the amount, the currency code, and the converted amount.
              - …
            - `tax` Money — Money object containing details such as the amount, the currency code, and the converted amount.
              - …
            - `base` Money — Money object containing details such as the amount, the currency code, and the converted amount.
              - …
            - `merchantFee` Money — Money object containing details such as the amount, the currency code, and the converted amount.
              - …

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — The specified resource was not found.

---

[API](https://skmtc.net/spotnana/apis/air-api.md) · [All operations](https://skmtc.net/spotnana/apis/air-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spotnana/air-api/versions/3009937ca024/schema)
