SeatAvailabillity 15.2 Live
version 2.57
New Functionality:
(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>
Message examples:
SeatAvailability.zip
EndPoint:
- IATA NDC Schema Version 15.2: https://test.api.iberia.com/iberia/beta/ndc/SeatAvailability/v1
HTTP Headers
api_key | Your unique key used to authorise access to the API. | Mandatory:Yes |
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.
= 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 |
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 |
|
|
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-sale | Schema | |||
---|---|---|---|---|
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 |
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 |
RecognizedTravelerList / RecognizedTraveler / PTC | Recognized Passenger Code | alphabetical | Passenger Types |
RecognizedTravelerList / RecognizedTraveler / Name / Surname | Surname of recognized passenger | alphabetical | Any |
RecognizedTravelerList / RecognizedTraveler / Name / Name | Name of recognized passenger | alphabetical | Any |
RecognizedTravelerList / RecognizedTraveler / FQTVs / AirlineID | Id of the airline | alphabetical | Any |
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 |
Seat Codes
CODE | DESCRIPTION |
---|---|
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 |
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 |