---
title: "Seat Map"
method: POST
path: "/air/search/seat/catalogofferingsancillaries/seatavailabilities"
tags: ["Seats Ancillaries EMDs"]
---

# Seat Map

`POST /air/search/seat/catalogofferingsancillaries/seatavailabilities`

The Seat Map request returns seat availability for both free and paid seats. It is a reference payload that sends identifiers from a previous transaction or a booking. You can send the Seat Map request at several places in the TripServices workflow - after searching, after pricing, during booking, and after booking. The Seat Map request uses the same endpoint but a different message payload depending on where in the workflow it is sent. See the supported workflow options in the [Seats Guide](https://developer.travelport.com/docs/flights/guides/seats-and-ancillaries/seats-guide). 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. Standalone Seat Map sends flight criteria including a booking code to return a view-only seat map. Unlike the Seat Map request, Standalone Seat Map does not send any identifiers from a previously searched or priced flight. It is instead a full payload request and can be sent entirely on its own, either within or outside of a workbench session.

## Headers

- `TraceId` string
- `XAUTH_TRAVELPORT_ACCESSGROUP` string
- `travelportPlusSessionIdentifier` string
- `TVP-PCC-Core` string

## Request body

- CatalogOfferingsQuerySeatAvailability — Used for a Seat Map request. Defines the request payload for returning seat availability for free and paid seats by referencing prior shopping, pricing, booking, or reservation data. This request can be sent at multiple points in the Air workflow: When sent after a Search request and prior to pricing or a workbench session, the Seat Map request sends identifiers from the Search response. When sent after a Price request and prior to initiating a workbench session, the Seat Map request sends identifiers from the Price response. When sent during a workbench session, the Seat Map request sends identifiers from the responses in the booking flow or, for a post-commit workbench, from the Workbench Create or Reservation Retrieve responses. The Standalone Seat map response is the same as the reference payload seat map response, with the exception that Result/Warning/Message is returned with the message 'The seatMap is view only'.
  - `@type` string, required — Discriminator class CatalogOfferingsQuerySeatAvailability only
  - `SeatAvailabilityOfferings` SeatAvailabilityOfferings, required
    - `@type` string, required — Discriminator classes SeatAvailabilityOfferingsBuildFromCatalogOfferings, SeatAvailabilityOfferingsBuildFromCatalogProductOfferings, SeatAvailabilityOfferingsBuildFromOffer, SeatAvailabilityOfferingsBuildFromOfferList, SeatAvailabilityOfferingsBuildFromProducts, and SeatAvailabilityOfferingsBuildFromReservationWorkbench
    - `CustomerLoyalty` CustomerLoyalty[] — Including a loyalty number causes the seat map service to recalculate availability, pricing, and eligibility using the traveler’s elite tier and benefits. The returned seat map reflects what that specific customer can select, not just what exists on the aircraft.
      - `value` string, required — Number on loyalty card.
      - `id` string — Optional Customer Loyalty Id. Not saved
      - `priority` integer — Optional Numeric Priority Code
      - `programId` string — Specifies an identifier to indicate the company owner of the loyalty program. Typically two characters. For frequent guest number, the hotel supplier or brand code. For frequent flyer number, the air supplier code of the loyalty program.
      - `programName` string — Supplier's loyalty program name.
      - `supplierType` string — The type of supplier of a loyalty program. Uses 'hotel' for frequent guest number or 'air' for frequent flyer number.
      - `supplier` string — Supplier of a loyalty program (typically 2 characters representing the hotel, brand, or airline).
      - `tier` string — Customer Loyalty tier
      - `shareWithSupplier` string[] — The list of suppliers that the CustomerLoyalty number is shared. Used for cross accrual programs. If valid carrier codes are not sent, the response returns the message NO CROSS ACCRUAL AGREEMENT EXISTS.
      - `cardHolderName` string — Customer loyalty member name; up to 128 characters are supported. In Air Search, for discounted offers to be returned, the name must be sent as LAST FIRST; e.g., if SMITH is the last name and JORDAN the first name, send as SMITH JORDAN
      - `validatedInd` boolean — Customer loyalty number has been validated by the supplier
      - `prefix` string — The cardholder name prefix title like Mr, Mrs, Dr
      - `given` string — The First Name of the Cardholder
      - `middle` string — Middle Name of the Cardholder
      - `surname` string — Last Name of the Cardholder

## Response `200`

OK - Successful Response - 200

- CatalogOfferingsAncillaryListResponseWrapper — Wrapper schema to expose the name of the top level schema in the JSON example
  - `CatalogOfferingsAncillaryListResponse` CatalogOfferingsAncillaryListResponse — Base response is part of all TripServices responses and includes common items which are relevant across all APIs
    - `@type` string
    - `transactionId` string — A unique system-generated (128 bit GUID format) transaction/tracking id for a single request and response (i.e. for a single transaction) used for internal tracking and troubleshooting. Also known as E2ETrackingId. Not returned in all Hotel API responses.
    - `traceId` string — Used in hospitality workflows to provide a unique transaction or tracking id for a single request and response. For Air Eligibility, returned if a custom trace ID was sent in the request header. For Hotel Rules, returned if a custom trace ID was sent in the request header.
    - `correlationId` string, uuid — Identifier used to correlate hotel API invocations across a multi-call business flows.
    - `reservationStatus` 'Success' | 'Fail' | 'Partial' | 'Pending' | 'OnHold' | 'Retry' | 'Other' — Status of reservation or offer completion.
    - `Result` Result — Returns the error and/or warning message information, if applicable.
      - `@type` string — Discriminator class Result only
      - `status` 'Not processed' | 'Incomplete' | 'Complete' | 'Unknown' — The status of an error or warning
      - `Error` Error[] — A list of error information returned at the provider level for a response.
        - `@type` string, required — Discriminator classes Error or ErrorDetail
        - `StatusCode` integer — Http standard response code
        - `Message` string — The Travelport standardized error or warning message
        - `NameValuePair` NameValuePair[]
          - `value` string — Text directly related to name description, providing more detail. May have character restrictions based on remark type (e.g. Free Text limitations: 84 characters, alphanumeric and some special characters).
          - `id` string — Optional internally referenced id
          - `name` string, required — Key, categorizing the type of remark or error.
      - `Warning` Warning[] — A list of warning information returned at the provider level for a response.
        - `@type` string, required — Discriminator classes Warning or WarningDetail
        - `StatusCode` integer — Http standard response code
        - `Message` string — The Travelport standardized error or warning message
        - `NameValuePair` NameValuePair[]
          - `value` string — Text directly related to name description, providing more detail. May have character restrictions based on remark type (e.g. Free Text limitations: 84 characters, alphanumeric and some special characters).
          - `id` string — Optional internally referenced id
          - `name` string, required — Key, categorizing the type of remark or error.
    - `Identifier` Identifier — A globally unique identifier key often used to reference a given option (such as Pricing, Booking, Rules, or additional workflows) or to retrieve information (such as Hotel pagination).
      - `value` string — Unique offer identifier that can be sent in subsequent payload requests to reference this offer. When used for reference flight calls, the CatalogProductOfferingsIdentifier will be the transaction identifier from the Search, Next Leg Search, or Flight Specific Search response in CatalogProductOfferings/Identifier/value. If you choose to pull the CatalogProductOfferingsIdentifier from the Price response instead (OfferListResponse/Identifier/value), either full or reference payload, please note for subsequent Add Offer requests you must remove the _PC appended to the end of the value in the AirPrice response (e.g., change value: '93d2091d-3d04-48ab-8091-6ae1525f02ea_PC' to value: '93d2091d-3d04-48ab-8091-6ae1525f02ea'). When building an AirPrice or Add Offer reference payload request: - Look for the CatalogProductOfferingIdentifier (ex: o1) in a Search response at CatalogProductOfferings/CatalogProductOffering/id or a Price response at OfferListResponse/OfferID/id. - Look for the ProductIdentifier (ex: p0) in a Search response at CatalogProductOfferings/CatalogProductOffering/ProductBrandOptions/ProductBrandOffering/Product/productRef or from a Price response at OfferListResponse/OfferID/Product/id. When returned from a Workbench, this value is the workbench identifier that must be sent in all subsequent requests for this workbench session. When returned from Air Exchange Eligibility, value is the ticket number sent with the eligibility request. When used specifically for form of payment, the value will begin with the characters 'FOP'. Similarly, the OfferIdentifier associated will begin with the character 'O'. For Hotel Create Reservation (Reference Payload), send the value from the Availability response in CatalogOffering/id or the value from SearchComplete returned in propertyItems/lowestPublicAvailableRate/rateKey/value. Results from Hotel Availability and Hotel SearchComplete are stored in the cache for 30 minutes. If the offers expire before booking, you must send a new request.
      - `authority` string — Name of the supplier system that created this identifier - the source of information. For AirPrice, please note that GDS offers return the value 'Travelport' in authority while NDC offers return the carrier code of the issuing NDC carrier. When returned from Air Exchange Eligibility, authority is always 'Travelport' as the transaction issuer. For Hotels, authority indicates which supplier returned the lowest available rate for that property: either 'TVPT' (Travelport) or 'BKNG' (booking.com). Booking.com access requires additional provisioning and a direct agreement with the supplier. Authority is not returned if the property is closed or returns an error. For Hotel Create Reservation (Full Payload) and Sync Reservation send the value from the Availability response in CatalogOffering/Identifier/authority for the instance you want to book.
    - `NextSteps` NextSteps — Container for the steps that describe actions that may be taken on the containing object. Not applicable for an Eligibility or Exchange response.
      - `baseURI` string, required — The base portion of the URI in order to shorten the uris in the individual steps
      - `id` string — Optional internally referenced id
      - `NextStep` NextStep[], required
        - `value` string
        - `id` string — Identifier for the Next Step
        - `action` string, required — The action this next step is intended to achieve
        - `method` 'GET' | 'DELETE' | 'PUT' | 'POST', required — Describes the set of potential methods that can be taken after an operation.
        - `description` string — Additional clarification for the next step
    - `ReferenceList` ReferenceList[]
      - `@type` string, required — Discriminator - Air Search child classes are ReferenceListAmenity, ReferenceListBrand, ReferenceListFlight, ReferenceListProduct, ReferenceListTermsAndConditions, and ReferenceListUniversalProductAttribute. - Air Price child classes are ReferenceListAmenity and ReferenceListBrand. - FareRules child class is ReferenceListFlight. - Search Ancillaries child class is ReferenceListFlight. - Seat Map child class is ReferenceListSeatingChart. - Hotel Availability child class is ReferenceListPropertyDates. - Reservation and Reservation Workbench child classes are ReferenceListAmenity, ReferenceListBrand, and ReferenceListUniversalProductAttribute. - Exchange Search child classes are ReferenceListBrand, ReferenceListFlight, and ReferenceListExchangedPrice. - Reservation Receipt child classes are ReferenceListOffer and ReferenceListTraveler. - Book_Traveler child class is ReferenceListTraveler.
      - `id` string — Uniquely identifies for the Reference List
    - `CurrencyRateConversion` CurrencyRateConversion[]
      - `@type` string
      - `SourceCurrency` CurrencyCode, required — Currency codes are the three-letter alphabetic codes that represent the various currencies used throughout the world. Unless changed in the request, the currency is the default associated with your provisioned PCC from Travelport. For Hotel: SourceCurrency is based on the location of the hotel and used for all rates in the response. TargetCurrency is the currency code sent in the request in requestedCurrency.
        - `value` string — An ISO 4217 currency code.
        - `codeAuthority` string — Currency code authority
        - `decimalPlace` integer — Number of decimal places for the currency.
        - `decimalAuthority` string — Currency code decimal authority
      - `TargetCurrency` CurrencyCode, required — Currency codes are the three-letter alphabetic codes that represent the various currencies used throughout the world. Unless changed in the request, the currency is the default associated with your provisioned PCC from Travelport. For Hotel: SourceCurrency is based on the location of the hotel and used for all rates in the response. TargetCurrency is the currency code sent in the request in requestedCurrency.
        - `value` string — An ISO 4217 currency code.
        - `codeAuthority` string — Currency code authority
        - `decimalPlace` integer — Number of decimal places for the currency.
        - `decimalAuthority` string — Currency code decimal authority
      - `ConversionRate` ConversionRate, required — Conversion rate of SourceCurrency value to TargetCurrency value. This value can be used to calculate, independently of the API, conversion for the rates in the response. The response does not convert any amounts.
        - `value` number, float
        - `rateAuthority` string — Contextual rate authority
        - `rateAsOf` string, date-time — Rate as of
    - `Pagination` Pagination — Pagination object used when result sets span across a number of pages.
      - `@type` string, required
      - `page` integer, required — The current page number of the full result set
      - `pageSize` integer, required — The total number of items on this page
      - `totalPages` integer, required — The total number of pages in this result set
      - `totalItems` integer, required — The total number of pages in this result set

## Other responses

- `201` — Created - 201
- `400` — Bad Request - 400
- `401` — Unauthorized - 401
- `402` — Payment Required - 402
- `403` — Forbidden - 403
- `404` — Not Found - 404
- `500` — Internal Server Error - 500
- `503` — Service Unavailable - 503. This error may be returned when the service is temporarily unavailable due to infrastructure or network issues.

---

[API](https://skmtc.net/travelport/apis/tripservices-flights.md) · [All operations](https://skmtc.net/travelport/apis/tripservices-flights/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/travelport/tripservices-flights/revisions/90abcc916990/schema)