What is it?
Stateless Seats Service is a lightweight API and can be used to retrieve seat map with prices (including price in points if applicable) and perform other operations related to the seats portion of a travel itinerary, like add or remove. The latest version of the API offers an ability of bulk add (single request may contain seats for multiple passengers for a single or multiple segments). This is applicable to seats/add operation.
Why use it?
Capabilities:
Leveraging this stateless seats service is accompanied by the following capabilities listed below.
-
Shop for seats for the requested flight gives your passenger the ability to retrieve the seat map along with the information about the price or discount (if applicable). Additionally, the service returns the price in points, if the airline offers an ability to pay with points for seats and the flight segment is eligible for a such transaction.
-
Adding seats: for the requested flight gives your passenger an option to reserve a seat in advance, and reduces the operation time during physical check in. API offers bulk add (user may specify seats for some/all passengers for a single or multiple segments). Bulk add supports two flavors, seats preference or seat’s numbers.
-
Removing seats: for the requested flight gives your passenger an ability to cancel an already reserved seat.
How it works
Shop for seats
Stateless Seats Shop Service [endpoint: seats/shop] provides a list of available seats for a specific flight for one or multiple passengers. Seat request should provide passenger/s details [passenger type etc] for single flight segment. The service responds with the seat map, seat prices and other relevant information. Seat availability and seat prices [free seats or paid seats], are based on given passenger data. Discounts are returned if applicable. Additionally, the service returns the price in points, if the request contains the flag "isAwardPricing" equal to true, and if the airline offers an ability to pay with points for seats and the flight segment is eligible for a such transaction. API offers two flavors:
- The user creates a request providing information about the desired flight, including the fare basis information, booking class etc. (Payload mode).
- The user creates a request providing an information about the particular seat offer (OfferId Mode).
Add seats
Stateless Seats Add Service [endpoint: seats/add] allows a user to book a specific seat/s for passenger/s for a specific single flight, in addition the user may apply seat price override. Prior to adding the specified seat, the user may call the above service [seats/shop] to obtain a list of available seats with prices [free seats or paid seats]. Based on the seat service response the user may then call the service seats/add to reserve the specific seat for the requested passengers that should be added to the reservation.
- The user provides information about the seat number and its reference to the passenger and segment. Instead of providing the seat number, the user may choose preference (for example: window seat).
- The user may provide a list of seats or preference for some/all passengers for a single or multiple flight segment(s). This is called a bulk add.
Remove seats
Stateless Seats Remove Service [endpoint: seats/remove] allows a user to cancel previously booked seat for a particular passenger for a flight segment. Please note that in this version of the service we support only a single seat operation (no bulk removing).
- The user provides information about the seat number to be removed from the record along with other data related to the flight segment.
How to use
You can download the postman collection with sample usage of Stateless Seats Service from our collection here. The collection contains details about how to setup and perform operations using stateless services.