SeatAvailability

 Our 17.2 version is available for trial in BETA: SeatAvailability Version 17

1.1 Functional Description

version 2.57

The SeatAvailability service returns priced seatmaps for the flights in the selected Offer or Order.

Seats can be purchased as part of the Shopping flow following the FlightPrice, or as part of a servicing flow after the initial booking has been made.

However, Seats cannot be pre-booked/purchased unless the Order has been paid for in full and ticketed.

Functionality:

SeatAvailability.zip message examples

Functionality Use

Pre-Sale

The pre-sale seat availability service allows us to see the price and availability of seats for flights before the creation of the Order. In this way, we can select those seats services that we want to include when creating the Order.
Post-Sale The post-sale seat availability service allows us to see the price and availability of seats for flights after the creation of the Order. In this way, we can select those seats services that we want to add to a previously created order
Pre-Sale + Post-Sale With this funcionality, we can elect those seat services that we want to include when creating the order. After create the order, we can select those seat services that we want to include them in a previously created order

(version: 2.30) In the Service element of the SeatAvailability response, there is more information returned regarding the seat service.

The elements are:

  • Traveler: contains the passangers references the seat service can be applied for.

Example of validation of the currency we sell with the point of sale currency.

    
    <Metadata>
        <Other>
            <OtherMetadata>
                <CurrencyMetadatas>
                    <CurrencyMetadata MetadataKey="EUR">
                    <Decimals>2</Decimals>
                    </CurrencyMetadata>
                </CurrencyMetadatas>
            </OtherMetadata>
        </Other>
    </Metadata>
        

EndPoint:

HTTP Headers

api_key Your unique key used to authorise access to the API. Mandatory:Yes

1.2 Request Body

We provide two different methods to request the seat availability:

  • Presale: Needs a previous AirShopping for returning an offer and a price breakdown.
  • Post-sale: Needs a previously created and full paid Order. Including extra data will return the seat availability for the ordered flight.

There are various search parameter for this endpoint.

Add = New

NAME

DESCRIPTION

FORMAT

ALLOWED VALUES

MANDATORY FOR
PrimaryLangID Specifies preferred language by the agency 2 alphabetic any
Version

The IATA version of the message

numeric any Schema
<PointOfSale>

Location / CountryCode

Country code

2 alpha

List of countries

NDC Mandatory if toggle feature for market validation is activated.
<Document> Schema

ReferenceVersion

The IATA Schema version.

numeric

any


<Party / Sender / TravelAgencySender> Schema

IATA_Number

Sender IATA or Pseudo IATA number

numeric

7/8 numbers

NDC Mandatory

AgencyID

Agency identification

alphanumeric

any

Schema
Name

Agency name

alphanumeric any
<Party / Sender / TravelAgencySender / Contacts / Contact> Mandatory for schema if 'Contacts' tag is indicated.
EmailContact / Address Email to contact the Agency alphanumeric any Mandatory for schema if 'EmailContact' tag is indicated.
PhoneContact / Application Agency phone type alphabetic
  • BUSINESS
  • MOBILE

PhoneContact / Number

Attribute

CountryCode

Country code phone number to contact the Agency alphanumeric any
Name / Surname Reference Agency contact surname alphanumeric any Mandatory for schema if 'Name' tag is indicated.
Name / Given Reference Agency contact given alphanumeric any
<Travelers> Schema

Traveler / AnonymousTraveler / PTC

Attribute Passenger Type Code

PaxType (3 alpha)

any

Schema

Traveler / AnonymousTraveler / PTC

Attribute

Quantity

Quantity of this kind of passenger type numeric any, from 1 to 9
<ShoppingResponseIDs> Presale Schema

ResponseID

ResponseID of FlightPrice service

alphanumeric

any

Schema
AssociatedIDs Offer Items alphanumeric
Schema
<Query> Post-saleSchema
OrderID Order ID with mandatory attribute Owner alphanumeric the order id of an existing order which has been created, paid and ticketed Schema
<Metadata>

Other / OtherMetadata / CurrencyMetadatas / CurrencyMetadata / MetadataKey

Attribute

MetadataKey

Type of currency alphanumeric any available currency Mandatory for schema if 'Metadata' tag is indicated
Other / OtherMetadata / CurrencyMetadatas / CurrencyMetadata / Decimals Decimals of currency numeric any Mandatory for schema if 'MetadataKey' tag is indicated

 1.3 Response Body

NAME

DESCRIPTION

FORMAT

ALLOWED VALUES
<ShoppingResponseIDs>

ResponseID

Id of the response alphabetical Any
<Flights>
OriginDestinationReference IATA standard reference for Origin Destination. (OriDestDate) alphabetical Any
FlightSegmentReferences IATA standard reference for flight alphabetical Any
Cabin / Code Code of the cabin alpha Any
Cabin / Definition Code definition of the cabin alphabetical Any
<Cabin / SeatDisplay>
Columns Column name alphabetical Any
Rows / First Cabin's first row numerical Number
Rows / Last Cabin's last row numerical Number
Component / Locations / Location / Row / position One location row position of a Component numerical Number
Component / Locations / Location / Column / position One location column position of a Component numerical Number
Component / Type / Code Description code of the Component alphabetical Seat Codes
<Services>

Service

Attribute

ObjectKey

ObjectKey attribute contains the ID of the seat service alphanumerical Any
<Services / Service>

ServiceID

Attribute

Owner

ID of the seat service

Owner attribute shows owner airline ID of the service.

alphabetical Any
Name Name of the seat service alphabetical Any
Enconding / RFIC / Code RFIC Code alpha RFIC Code
Enconding / Code Code of the service alpha Any
Descriptions / Description / Text Description of the seat service alphabetical Any

Price / Total

Attribute

Code


Price of the seat

Code attribute shows currency code of the seat service.

number Number
Associations / Traveler / Traveler References Traveler referentes about passengerIDs alphanumerical Any
Associations / Flight / SegmentReferences Segment referentes with format flight number and flight date alphanumerical Any
<DataList>

AnonymousTravelerList / AnonymousTraveler

Attribute

ObjectKey

Anonymous Passenger key alphabetical Any
AnonymousTravelerList / AnonymousTraveler / PTC Anonymous Passenger Code alphabetical Passenger Types
(plus) RecognizedTravelerList / RecognizedTraveler / PTC Recognized Passenger Code alphabetical Passenger Types
(plus) RecognizedTravelerList / RecognizedTraveler / Name / Surname Surname of recognized passenger alphabetical Any
(plus) RecognizedTravelerList / RecognizedTraveler / Name / Name Name of recognized passenger alphabetical Any
(plus) RecognizedTravelerList / RecognizedTraveler / FQTVs / AirlineID Id of the airline alphabetical Any
(plus) RecognizedTravelerList / RecognizedTraveler / FQTVs / Account / Number Number of frecuent flyer numeric Any
<FlightSegmentList>

FlightSegment

Attribute

SegmentKey

Flight Segment Code containing FlightId and date alphanumerical Any
<FlightSegment / Departure>
AirportCode IATA Airport Code alphabetical Any
Date Departure Date Date yyyy-MM-dd
Time Departure Time Time hh:mm
AirportName Full Airport Name alphabetical Any
Terminal / Name Terminal name or number. Real world name for terminal alphabetical/numerical Any
<FlightSegment / Arrival>
AirportCode IATA Airport Code alphabetical Any
Date Arrival Date Date yyyy-MM-dd
Time Arrival Time Time hh:mm
AirportName Full Airport Name alphabetical Any
ChangeOfDay Shows how many days after departure date flight will arrive. numerical Number
Terminal / Name Terminal name or number. Real world name for terminal alphabetical/numerical Any
<FlightSegment / MarketingCarrier>
AirlineID IATA airline code alphabetical Any
Name Full Airline name. alphabetical Any
FlightNumber The flight number numerical Number

<FlightSegment / OperatingCarrier>

AirlineID IATA airline code alphabetical Any
Name Full Airline name. alphabetical Any
FlightNumber The flight number numerical Number
Disclosure / Description / Text Text showing the disclosure alphabetical Any
<FlightSegment / Equipment>
AircraftCode Aircraft Code numerical Number
Name Full Aircraft model name alphabetical Any
<FlightSegment / FlightDetail (only first segment)>
FlightDuration / Value Time Flight Duration Date PT'hh'H'mm'M
<FlightList>

Flight

Attribute

FlightKey

Id for the flight alphanumerical Any
<FlightList / Flight>
Journey / Time Time for the journey Date Any
SegmentReferences Id referencing a FlightSegment alphanumerical Any
<OriginDestinationList>

OriginDestinationList

Attribute

OriginDestinationKey

IATA Code referencing departure city and arrival city alphabetical Any
DepartureCode IATA Code for Departure City alphabetical Any
ArrivalCode IATA Code for Arrival City alphabetical Any
FlightReferences Id Referencing a Flight. alphanumerical Any
<MediaList>
Media

Attribute

ListKey

Id for the Media Item alphabetical Any
Media / MediaLink Http link referring to the Media Item alphanumerical Any
<SeatList>

Seats

Attribute

Refs

Id of the Seat alphanumerical Any
<SeatList / Seats / Location>
Column Refers to the column of the plane character Character
Row / Number Refers to the row of the plane numerical Number
Characteristics / Characteristic / Code Code for the characteristic of the seat numerical/alphabetical Seat Code

 

 

 

1.4 Seat Codes

CODEDESCRIPTION
1 Restricted seat - General 
2 Leg rest available 
3 Individual video screen - Choice of movies
4 Not a window seat 
5 Not an aisle seat 
6 Near galley seat 
7 Near toilet seat 
8 No seat at this location 
9 Center seat (not window, not aisle)
10 Seat designated for RBD "A" 
11 Seat designated for RBD "B" 70
12 Seat designated for RBD "C"
13 Seat designated for RBD "D"
14 Seat designated for RBD "F"
15 Seat designated for RBD "H"
16 Seat designated for RBD "J"
17 Seat designated for RBD "K"
18 Seat designated for RBD "L"
19 Seat designated for RBD "M"
20 Seat designated for RBD "P"
21 Seat designated for RBD "Q"
22 Seat designated for RBD "R"
23 Seat designated for RBD "S"
24 Seat designated for RBD "T"
25 Seat designated for RBD "V"
26 Seat designated for RBD "W"
27 Seat designated for RBD "Y"
28 Not fitted 
A Aisle seat 
AA All available aisle seats
AB Seat adjacent to bar
AC Seat adjacent to - closet
AG Seat adjacent to galley
AJ Adjacent aisle seats
AL Seat adjacent to lavatory
AM Individual movie screen - No choice of movie selection
AR No seat - airphone
AS Individual airphone
AT Seat adjacent to table
AU Seat adjacent to stairs to upper deck
AV Only available seats
AW All available window seats
B Seat with bassinet facility
BA No seat - bar
BK Blocked Seat for preferred passenger in adjacent seat
C Crew seat 
CC Center section seat(s)
CH Chargeable seat
CL No seat - closet
CS Conditional seat-contact airline
D No seat - exit door
DE Deporte
E Exit and emergency exit
EA Not on exit seat
EC Electronic connection for lap top or FAX machine
EK Economy comfort seat
EX No seat - emergency Exit
F Added seat 
FC Front of cabin class/compartment
G Seat at forward end of cabin
GF General facility
GN No seat - galley
GR Group seat - offered to travellers belonging to a group
H Seat with facilities for handicapped/incapacitated passenger
I Seat suitable for adult with an infant
IA Inside aisle seats
IE Seat not suitable for child
J Rear facing seat
K Bulkhead seat
KA Bulkhead seat with movie screen
KN Bulkhead, no seat 71
L Leg space seat
LA No seat – lavatory
LB Rear facing lie flat seat
LE Left facing lie flat seat more left angle
LF Lie flat seat
LG No seat - luggage storage
LH Restricted seat - offered on long-haul segments
LL Left facing lie flat seat
LR Right facing lie flat seat
LS

Left side of aircraft

LT Right facing lie flat seat more right angle
M Seat without a movie view
MA Medically OK to travel
MS Middle seat
N No smoking seat
O Preferential seat
OW Overwing seat(s)
P Extra seat for comfort - arm rest can be raised
PC Pet cabin 
Q Seat in a quiet zone
RS Right side of aircraft
S Smoking seat
SC Skycouch 
SO No seat - storage space
ST No seat - stairs to upper deck
T Rear/Tail section of aircraft
TA No seat - table
U Seat suitable for unaccompanied minors
UP Upper deck 
V Seat to be left vacant or offered last
W Window seat 
WA Window and aisle together
X No facility seat (indifferent seat)
Z Buffer zone seat
1A Seat not allowed for infant
1B Seat not allowed for medical
1C Seat not allowed for unaccompanied minor
1D Restricted recline seat
1M Seat with movie view
1W Window seat without window
3A Individual video screen - No choice of movie
3B Individual video screen-Choice of movies, games, information, etc
6A In front of galley seat
6B Behind galley seat
7A In front of toilet seat
7B Behind toilet seat
70 Individual video screen - services unspecified
71 No seat --access to handicapped lavatory
72 Undesirable seat

1.5 Error messages

NDC Standard allow errors and warnings to be returned inside an 200 OK response. Errors returned with 200 OK will always be controlled errors result of external limitations as "Max accepted non-infant passengers is 9".

HTTP STATUS CODE

EXAMPLE MESSAGE ERROR

REASON

396 Invalid ticket/document coupon status Order without tickets.
396 Invalid ticket/document coupon status Order with some ticket in status distinct of OPEN FOR USE
396 Invalid ticket/document coupon status Order with some ticket reissued