Standalone Seat Map API Reference

POST

search/seat/catalogofferingsancillaries/seatavailabilities

Base path:

Pre-production https://api.pp.travelport.com/11/air/

Production https://api.travelport.com/11/air/

Related Content: Seats Guide, Seat Book API Reference

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.

To subsequently select a seat, you must send a Seat Book request in a workbench session to add the selected seat/s to the workbench.

GDS only; not supported for NDC.

Request

Also see Authorization and Common Headers.

Query Parameters

None.

Request Body

Object Description Required/Optional

CatalogOfferingsQuerySeatAvailability

Top level object.

Required

SeatAvailabilityOfferings

Top level object.

Send with @type value SeatAvailabilityOfferingsBuildFromProducts.

Required

ProductCriteriaAir

Top level object for itinerary details.

Includes SpecificFlightCriteria.

Required

SpecificFlightCriteria

Array. Each instance sends details for each segment on the itinerary to price.

Required

carrier

String. IATA code of airline carrier for flight.

Required

flightNumber

String. Flight number assigned by airline.

Required

departureDate

String. Departure date of flight in YYYY-MM-DD format (e.g., departureDate="2024-12-06")

Required

departureTime

String. Departure time of flight. HH:MM:SS (24-hour) format (e.g., departureTime="18:00").

Required

arrivalDate

String. Arrival date of flight in YYYY-MM-DD format.

Required

arrivalTime

String. Arrival time of flight in HH:MM:SS (24-hour) format.

Required

from

String. IATA airport code of departure.

Required

to

String. IATA airport code of arrival.

Required

cabin

String. Cabin class to price.

Optional

classOfService

String. Class of service to price.

Required

brandTier

 String. The brand tier to price, if brand tier pricing is desired. Supported only in the full payload request. Optional.

Optional

segmentSequence

Sequence of this segment on the leg, starting with 0 for the first segment on the leg. A segment is one flight with the same flight number.

Required

AvailabilitySourceCode

Recommended to send in the full payload request.

Supported values and definitions for AvailabilitySourceCode are as follows:

  • A: AVS (availability and schedules)
  • B: Travelport cache
  • C: AVS
  • D: Direct Access
  • E: Travelport cache
  • F: Travelport cache
  • G: Travelport cache
  • H: Travelport cache
  • I: Travelport cache
  • K: Travelport cache
  • L: Last seat availability
  • M: Unknown source
  • O: Travelport cache
  • P: Travelport cache
  • Q: Travelport cache
  • S: Seamless
  • T: Travelport cache
  • U: Unknown source
  • X: Customer reusing availability data from customer cache (data originally obtained from Travelport)
  • Y: Customer reusing data obtained from another system (e.g., another GDS) (data may be fresh or stored in customer cache)
  • Z: Customer sold from e-streamed data stored in customer cache

Optional but recommended

ContentSource

Send with the value GDS.

Optional

boundFlightsInd

Boolean. Send with value true to request a sell/ignore availability check on connecting flight/s as well as the initial flight on a leg,

Optional

Response

The Standalone Seat map response is the same as the reference payload seat map response, with the exception that a Result/Warning/Message is returned with the message The seatMap is view only. See the Seat Map API Reference for response details.

Example Request

For additional examples and scenarios, download the developer toolkits and see Using Postman and Developer Toolkits.
{
 "CatalogOfferingsQuerySeatAvailability": {
  "SeatAvailabilityOfferings": {
   "@type": "SeatAvailabilityOfferingsBuildFromProducts",
   "ProductCriteriaAir": {
    "@type": "ProductCriteriaAir",
    "sequence": 1,
    "SpecificFlightCriteria": [
     {
      "@type": "SpecificFlightCriteria",
      "carrier": "QF",
      "flightNumber": "940",
      "departureDate": "2024-06-30",
      "departureTime": "17:35:00",
      "arrivalDate": "2024-06-30",
      "arrivalTime": "23:55:00",
      "from": "PER",
      "to": "BNE",
      "cabin": "Economy",
      "classOfService": "Q",
      "brandTier": 2,
      "segmentSequence": 1,
      "AvailabilitySourceCode": "Z",
      "ContentSource": "GDS",
      "boundFlightsInd": true
     }
    ]
   }
  }
 }
}

Example Response

The Standalone Seat map response is the same as the reference payload seat map response, with the exception that a Result/Warning/Message is returned with the message The seatMap is view only. See the Seat Map API Reference for an example response.