SeatAvailability 17.2
Functional Description
SeatAvailability API 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.
Seat map will only be returned for IB, I2, YW and Level operated flights.
Special Discounts (Spanish Resident Discount, Spanish Large Family Discount, Private Fare Discount and Frecuent Flyer Discount) in the offer/order are applied to the seat map search.
NDC Servicing operations for corporate will only validate that travel agency indicated in the request is the same as generated the order. If corporateID is present in the request, it will only be checked when the order has been generated with corporateID.
Functionality |
Use |
| Pre-Sale |
The pre-sale seat availability service allows us to see the availability of seats for a flight before the creation of the reservation, 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 availability of seats for a flight after the creation of the reservation,
In this way, we can select those seats services that we want to include them in a previously created order |
New or Modified field 
To be removed/deprecated
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.
The various search parameters are described below:
| NAME | DESCRIPTION | FORMAT | ALLOWED VALUES | MANDATORY FOR |
|---|---|---|---|---|
| PrimaryLangID | Two character ISO Language Code, for the agent’s preferred language. This is for error messages and some other data such as legal waivers. | 2 alpha |
|
|
| Version | The IATA version of the message | Numeric | Any | Schema |
| <PointOfSale> | ||||
| Location / CountryCode | Country code | 2 Alphabetical | List of Countries | If toggle feature for market validation is activated. |
| <Document> | Schema | |||
| ReferenceVersion | The IATA Schema version | Numeric | Any | |
| <Party / Sender> Only for Real IATA | Schema | |||
| TravelAgencySender / IATA_Number |
Sender unique identifier such as: IATA number (if you have one) TIDs number (recommended if you do not have an IATA) |
Numeric | 7/8 Numbers | NDC Mandatory |
| <Party / Sender> Only for Pseudo IATA | Schema | |||
| TravelAgencySender / OtherIDs / OtherID | Pseudo IATA (assigned by Iberia) | Numeric | 7/8 Numbers | NDC Mandatory |
| <Party> | Schema | |||
| Sender / TravelAgencySender / Name | Agency Name | Alphanumeric | Any | |
| Sender / TravelAgencySender / Contacts / Contact / EmailContact / Address | Email to contact the Agency | Alphanumeric | Any | Mandatory for schema if 'EmailContact' tag is indicated. |
| Sender / TravelAgencySender / Contacts / Contact / PhoneContact / Application | Agency phone type | Alphabetical |
|
|
| Sender / TravelAgencySender / Contacts / Contact / PhoneContact / Number | Phone number to contact the Agency | Numeric | Any | |
| Sender / TravelAgencySender / Contacts / Contact / Name / Surname | Reference Agency contact surname | Alphanumeric | Any | |
| Sender / TravelAgencySender / Contacts / Contact / Name / Given | Reference Agency contact name | Alphanumeric | Any | Mandatory for schema if 'Name' tag is indicated. |
| Sender / TravelAgencySender / AgencyID | Name of the Sender / Agency | Alphanumeric | Any | Schema |
| Participants / Participant / AggregatorParticipant / AggregatorID |
Participant / Aggregator unique identifier: IATA number (if you have one) TIDs number (recommended if you do not have an IATA) Pseudo IATA(assigned by Iberia) |
7 Numeric | 7 Numeric | Mandatory for schema if 'Participants' tag is indicated. |
| <Party> (With Corporates) | Schema | |||
| Sender / CorporateSender / ID | ID for the Corporate | Alphanumeric | Any | NDC Mandatory |
| Participants / Participant / TravelAgencyParticipant / Name | Agency Name | Alphanumeric | Any | |
| Participants / Participant / TravelAgencyParticipant / Contacts / Contact / EmailContact / Address | Email to contact the Agency | Alphanumeric | Any | Mandatory for schema if 'EmailContact' tag is indicated. |
| Participants / Participant / TravelAgencyParticipant / Contacts / Contact / PhoneContact / Application | Agency phone type | Alphabetical | ||
| Participants / Participant / TravelAgencyParticipant / Contacts / Contact / PhoneContact / Number | Phone number to contact the Agency | Numeric | Any | |
| Participants / Participant / TravelAgencyParticipant / Contacts / Contact / Name / Surname | Reference Agency contact surname | Alphanumeric | Any | |
| Participants / Participant / TravelAgencyParticipant / Contacts / Contact / Name / Given | Reference Agency contact name | Alphanumeric | Any | Mandatory for schema if 'Name' tag is indicated. |
| Participants / Participant / TravelAgencyParticipant / IATA_Number |
Sender unique identifier such as: IATA number (if you have one) TIDs number (recommended if you do not have an IATA) |
Numeric | 7/8 Numbers | NDC Mandatory |
| Participants / Participant / TravelAgencyParticipant / AgencyID | Id for the Agency | Alphanumeric | Any | Schema |
| Participants / Participant / AggregatorParticipant / AggregatorID |
Participant / Aggregator unique identifier: IATA number (if you have one) TIDs number (recommended if you do not have an IATA) Pseudo IATA(assigned by Iberia) |
7 Numeric | 7 Numbers | Mandatory for schema if 'Participants' tag is indicated. |
| <Query> Pre-Sale | Schema | |||
|
Offer Attribute OfferID Attribute ResponseID |
Id of a returned offer Id of the response |
Alphanumeric Alphanumeric |
Any Any |
Schema |
| <Query> Post-Sale | ||||
|
Order Attribute OrderID |
Id of a returned order | Alphanumeric | Any | Schema |
| <Metadata> | ||||
|
Other / OtherMetadata / CurrencyMetadatas / CurrencyMetadata Attribute MetadataKey |
Type of currency | Alphabetical | Any available currency for the defined market | Mandatory for schema if 'Metadata' tag is indicated |
| Other / OtherMetadata / CurrencyMetadatas / CurrencyMetadata / Decimals | Decimals of the currency | Numeric | Any | |
Response Body
The response filters by currency in both pre-sale and post-sale methods. In case the currency does not match with:
- Pre-sale: with the currency in the offer.
- Post-sale: with the currency in the order.
If the seat has a price of 0 (zero), as the currency is not provided, it is not filtered.
| NAME | DESCRIPTION | FORMAT | ALLOWED VALUES | Nullable |
|---|---|---|---|---|
| <Document> | ||||
| ReferenceVersion | The IATA version of the message | Numeric | Any | False |
| <ShoppingResponseID> | ||||
| ResponseID | Id of the response | Alphanumeric | Any | False |
| <ALaCarteOffer> | ||||
|
ALaCarteOffer Attribute OfferID |
Id of the Offer | Alphanumeric | Any | False |
| OfferExpirationDateTime | Date of expiration for the offer | Alphanumeric | Any | False |
| <ALaCarteOffer / ALaCarteOfferItem> | ||||
|
ALaCarteOfferItem Attribute OfferItemID |
Id of the OfferItem | Alphanumeric | Any | False |
| Eligibility / PassengerRefs | Passenger Identifier | Alphanumeric | Any | False |
| Eligibility / SegmentRefs | Segment Identifier | Alphanumeric | Any | False |
| UnitPriceDetail / TotalAmount / SimpleCurrencyPrice | Unitary price for the offer | Numeric | Any | False |
|
Service Attribute ServiceID |
Id of the service | Alphanumeric | Any | False |
| Service / ServiceDefinitionRef | Service Identifier | Alphanumeric | Any | False |
| <SeatMap> | ||||
| SegmentRef | Segment Identifier | Alphanumeric | Any | False |
| <SeatMap / Cabin> | ||||
| CabinType / Code | Code for the cabin type | Alphabetical | Any | False |
| CabinType / Definition | Definition for the cabin type | Alphabetical | Any | False |
| CabinLayout / Columns | Columns for the cabin | Alphabetical | Any | False |
| CabinLayout / Rows / First | First row for the cabin | Numeric | Any | False |
| CabinLayout / Rows / Last | Last row for the cabin | Numeric | Any | False |
| Row / Number | Number for the row | Numeric | Any | False |
| Row / Seat / Column | Column for the seat | Alphabetical | Any | False |
| Row / Seat / SeatStatus | Status of the seat | Alphabetical | Any | False |
| Row / Seat / SeatCharacteristics / Code | Characteritc of the seat | Alphabetcial | Any | True |
| Row / Seat / OfferItemRefs | Reference of the OfferItem | Alphanumeric | Any | False |
| <Metadata / Other / OtherMetadata / CurrencyMetadatas> | ||||
|
CurrencyMetadata Attribute MetadataKey |
Id for the Metadata | Alphanumeric | Any | True |
| CurrencyMetada / Decimals | Number of decimals | Numeric | Any | True |
| <DataLists / PassengerList> | ||||
|
Passenger Attribute PassengerID |
Passenger Identifier | Alphanumeric | Any | False |
| Passenger / PTC | Attribute Passenger Type Code | PaxType (3 Alphabetical) | Type of Passengers | False |
| <DataLists / FlightSegment> | ||||
|
FlightSegment Attribute SegmentKey |
Id for the segment | Alphanumeric | Any | False |
| Departure / AirportCode | IATA 3 character code for the departure city/airport/station | 3 Alphanumeric | Any | False |
| Departure / Date | Date of departure | Date | yyyy-MM-dd | False |
| Departure / Time | Time of departure | Hour | HH:mm | False |
| Departure / AirportName | Name of the departure city/airport/station | Alphanumeric | Any | False |
| Departure / Terminal / Name | Name of the departure terminal at city/airport/station | Alphanumeric | Any | False |
| Arrival / AirportCode | IATA 3 character code for the arrival city/airport/station | 3 Alphanumeric | Any | False |
| Arrival / Date | Date of arrival | Date | yyyy-MM-dd | False |
| Arrival / Time | Time of arrival | Hour | HH:mm | False |
| Arrival / ChangeOfDay | Number of days to change | Numeric | Any | False |
| Arrival / AirportName | Name of the arrival city/airport/station | Alphanumeric | Any | False |
| Arrival / Terminal / Name | Name of the arrival terminal at city/airport/station | Alphanumeric | Any | False |
| MarketingCarrier / AirlineID | Id for the airline that markets the flight | Alphanumeric | Any | False |
| MarketingCarrier / Name | Name for the airline that markets the flight | Alphanumeric | Any | False |
| MarketingCarrier / FlightNumber | Number for the flight | Numeric | Any | False |
| OperatingCarrier / AirlineID | Id for the airline that operates the flight | Alphanumeric | Any | False |
| OperatingCarrier / Name | Name for the airline that operates the flight | Alphanumeric | Any | False |
| OperatingCarrier / FlightNumer | Number for the flight | Numeric | Any | False |
| OperatingCarrier / Disclosures / Description / Text | Description of the airline | Alphanumeric | Any | False |
| Equipment / AircraftCode | Code of the aircraft that operates the flight | Alphanumeric | Any | False |
| Equipment / Name | Name of the aircraft that operates the flight | Alphanumeric | Any | False |
| FlightDetail / FlightDuration / Value | Duration of the flight | Alphanumeric | Any | False |
| <DataLists / MediaList> | ||||
|
Media Attribute ListKey |
Id for the Media Item | Alphanumeric | Any | False |
| Media / MediaLink | Http link referring to the Media Item | Alphanumeric | Any | False |
| <DataLists / ServiceDefinitionList> | ||||
|
ServiceDefinition Attribute ServiceDefinitionID |
Id for the service definition | Alphanumeric | Any | False |
| ServiceDefinition / Name | Name of the service | Alphanumeric | Any | False |
| ServiceDefinition / Descriptions / Description / Text | Description of the service | Alphanumeric | Any | False |
Seat Codes
| 9865 - SEAT OCCUPATION | |
|---|---|
| CODE | DESCRIPTION |
| 1 | Seat waitlist open for segment |
| 2 | Seat waitlist closed for segment |
| 3 | Seats on request only to airline |
| B | Advanced boarding pass seat |
| C | Check-in reserved seat |
| D | Seat blocked for/with deadload |
| E | Extra seat |
| F | Seat is free |
| G | Seat for group pre-allocation |
| H | Courtesy reserved seat 78 |
| I | Seat is not available for interline through check-in |
| M | Seat occupied for medical reasons |
| N | Seat not designated for RBD specified in request |
| O | Seat is occupied |
| P | rotected seat |
| Q | No seat here |
| R | Reserved seat generic |
| S | Seat protected for code sharing |
| T | Transit passenger - seat occupied by a transit passenger or load |
| U | Upline protected seat |
| V | Downline protected seats |
| X | Seat is not available for partner airlines use |
| Y | Advanced seat selection seat |
| Z |
Seat blocked for other reasons |
| 9864 - ROW CHARASTERISTIC | |
|---|---|
| CODE | DESCRIPTION |
| 10 | Row designated for RBD "A" |
| 11 | Row designated for RBD "B" |
| 12 | Row designated for RBD "C" |
| 13 | Row designated for RBD "D" |
| 14 | Row designated for RBD "F" |
| 15 | Row designated for RBD "H" |
| 16 | Row designated for RBD "J" |
| 17 | Row designated for RBD "K" |
| 18 | Row designated for RBD "L" |
| 19 | Row designated for RBD "M" |
| 20 | Row designated for RBD "P" |
| 21 | Row designated for RBD "Q" |
| 23 | Row designated for RBD "S" |
| 24 | Row designated for RBD "T" |
| 25 | Row designated for RBD "V" |
| 26 | Row designated for RBD "W" |
| 27 | Row designated for RBD "Y" |
| A | Extra leg room |
| B | Buffer row |
| C | Row with cabin facilities in a designated column |
| CC | Row with cabin facilities in an undesignated column |
| CH | Chargeable seat |
| D | Seat restrictions apply in this row |
| E | Exit row |
| EC | Exit row with cabin facilities in a designated column |
| EL | Exit left |
| ER | Exit right |
| FC | Front of cabin/class compartment |
| I | Indifferent row |
| K | Overwing row |
| L | Lowerdeck row |
| M | Maindeck row |
| MW | Row with movie screen |
| N | No-smoking row |
| S | Smoking row |
| U | Upperdeck row |
| X | Not overwing row |
| XC | Exit row with cabin facilities in an undesignated column |
| Z | Row does not exist |