Booking | GetSeatAvailability
Get seat availability for a specific flight.
Notice:
Product Scope: FareMarket, TechHub, TechHub+
POST
/flight/bookingParameter
| Field | Mandatory | Type | Scope | Description |
|---|---|---|---|---|
| action | required |
String | GetSeatAvailability | |
| key | required |
String | API security key applied from AeroHub | |
| signature | required |
String | Refer to Guideline to generate. | |
| timestamp | required |
Int | The ‘timestamp’ field should be a 10-digit Unix timestamp in seconds, used for encryption and data verification. | |
| version | optional |
String | API version information, e.g. 3.2.0 | |
| request | required |
Object | ||
| arrAirport | required |
String | Arrival airport IATA 3-letter code. | |
| data | required |
String | Session data for AeroHub internal use, retrieve from AirPricing. | |
| depAirport | required |
String | Departure airport IATA 3-letter code. | |
| depTime | required |
String | Departure date, format: YYYYMMDDHHMM | |
| flightNumber | required |
String | Flight number, e.g. CA123 | |
| sessionId | required |
String | SessionId，generated from AirPricing |
Request_Example:
{ "action": "GetSeatAvailability", "key": "2n2PMAyqEsnSMQrl1", "signature": "WAHzApldOIXbk6Zp3PJq7qUySXgeRD5W/CaxkoTpFphj0=", "timestamp": 1685116516, "request": { "arrAirport": "BOM", "data": "AXAASS/9RNI9W", "depAirport": "LHR", "depTime": "202603202030", "flightNumber": "AI130", "sessionId": "dd53a6a8b602b9222a6a13683c3425f94" } }
Response
| Field | Type | Description |
|---|---|---|
| status | int | 0 for success, others for failure, refer to status error appendix for details |
| msg | String | Return message, maximum 64 char |
| contentStatus | int | Return the original code from airlines or suppliers. |
| contentMsg | String | Return the original message from airlines or suppliers, maximum 64 char |
| seats | Object | Object array for aircraft response |
| aircraftCode | String | code of the aircraft |
| flightNumber | String | Flight number, e.g. CA123 |
| depTime | String | Departure date and time, format: YYYYMMDDHHMM e.g. 201203100315 means 2012/03/10 03:15 |
| arrAirport | String | Arrival airport IATA 3-Letter Codes |
| depAirport | String | Departure airport IATA 3-Letter Codes |
| seatCols | Object[] | Object array for seat price response |
| deck | Float | Deck identifier (e.g. M, U) |
| items | String[] | Seat entries within the current deck/column group |
| currency | String | currency 3-letter code. e.g. USD |
| adultAmount | Float | Adult seat amount |
| adultOriginalAmount | Float | Original adult seat amount |
| childAmount | Float | Child seat amount |
| childOriginalAmount | Float | Original child seat amount |
| originalCurrency | String | Original currency 3-letter code. e.g. USD |
| cabinClass | String | RBD code generated from airline |
| rowNo | String | seat row number |
| colNo | String | seat column number |
| deck | String | seat deck. e.g. M |
| nearAisle | Int | Whether seat is near aisle: 0: Unknown 1: Yes 2: No |
| nearExit | Int | Whether seat is near the exit: 0: Unknown 1: Yes 2: No |
| nearLavatory | Int | Whether seat is near lavatory: 0: Unknown 1: Yes 2: No |
| nearWindow | Int | Whether seat is near window: 0: Unknown 1: Yes 2: No |
| overWing | Int | Whether seat is in overwing: 0: Unknown 1: Yes 2: No |
| status | Int | Seat availability status. 1 = available, 0 = unavailable |
| withInfant | Int | Whether the passenger is traveling with an infant: 0: Unknown 1: Yes 2: No |
| allowChildSelected | Int | Whether the seat can be selected for a child passenger. 1: Yes 0: No 2: Unknown |
| data | String | encrypt data for AeroHub internal use |
Success-Response
{ "status": 0, "msg": "success", "seats": { "flightNumber": "AI130", "depAirport": "LHR", "arrAirport": "BOM", "depTime": "202603202030", "aircraftCode": "", "seatCols": [ { "deck": "M", "items": [ { "cabinClass": "Y", "rowNo": "16", "colNo": "A", "deck": "M", "status": 0, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 0, "nearExit": 0, "nearLavatory": 0, "nearWindow": 1, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 60.77, "adultAmount": 60.77, "childOriginalAmount": 60.77, "childAmount": 60.77 }, { "cabinClass": "Y", "rowNo": "16", "colNo": "B", "deck": "M", "status": 1, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 0, "nearExit": 0, "nearLavatory": 0, "nearWindow": 0, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 55.77, "adultAmount": 55.77, "childOriginalAmount": 55.77, "childAmount": 55.77 }, { "cabinClass": "Y", "rowNo": "16", "colNo": "C", "deck": "M", "status": 1, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 1, "nearExit": 0, "nearLavatory": 0, "nearWindow": 0, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 60.77, "adultAmount": 60.77, "childOriginalAmount": 60.77, "childAmount": 60.77 }, { "cabinClass": "Y", "rowNo": "16", "colNo": "D", "deck": "M", "status": 0, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 1, "nearExit": 0, "nearLavatory": 0, "nearWindow": 0, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 0.73, "adultAmount": 0.73, "childOriginalAmount": 0.73, "childAmount": 0.73 }, { "cabinClass": "Y", "rowNo": "16", "colNo": "E", "deck": "M", "status": 1, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 0, "nearExit": 0, "nearLavatory": 0, "nearWindow": 0, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 55.77, "adultAmount": 55.77, "childOriginalAmount": 55.77, "childAmount": 55.77 }, { "cabinClass": "Y", "rowNo": "16", "colNo": "F", "deck": "M", "status": 0, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 0, "nearExit": 0, "nearLavatory": 0, "nearWindow": 0, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 0.73, "adultAmount": 0.73, "childOriginalAmount": 0.73, "childAmount": 0.73 }, { "cabinClass": "Y", "rowNo": "16", "colNo": "G", "deck": "M", "status": 1, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 1, "nearExit": 0, "nearLavatory": 0, "nearWindow": 0, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 60.77, "adultAmount": 60.77, "childOriginalAmount": 60.77, "childAmount": 60.77 }, { "cabinClass": "Y", "rowNo": "16", "colNo": "H", "deck": "M", "status": 1, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 1, "nearExit": 0, "nearLavatory": 0, "nearWindow": 0, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 60.77, "adultAmount": 60.77, "childOriginalAmount": 60.77, "childAmount": 60.77 }, { "cabinClass": "Y", "rowNo": "16", "colNo": "J", "deck": "M", "status": 1, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 0, "nearExit": 0, "nearLavatory": 0, "nearWindow": 0, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 55.77, "adultAmount": 55.77, "childOriginalAmount": 55.77, "childAmount": 55.77 }, { "cabinClass": "Y", "rowNo": "16", "colNo": "K", "deck": "M", "status": 1, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 0, "nearExit": 0, "nearLavatory": 0, "nearWindow": 1, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 60.77, "adultAmount": 60.77, "childOriginalAmount": 60.77, "childAmount": 60.77 }, { "cabinClass": "Y", "rowNo": "17", "colNo": "A", "deck": "M", "status": 1, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 0, "nearExit": 0, "nearLavatory": 0, "nearWindow": 1, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 30.82, "adultAmount": 30.82, "childOriginalAmount": 30.82, "childAmount": 30.82 }, { "cabinClass": "Y", "rowNo": "17", "colNo": "B", "deck": "M", "status": 1, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 0, "nearExit": 0, "nearLavatory": 0, "nearWindow": 0, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 30.82, "adultAmount": 30.82, "childOriginalAmount": 30.82, "childAmount": 30.82 }, { "cabinClass": "Y", "rowNo": "17", "colNo": "C", "deck": "M", "status": 0, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 1, "nearExit": 0, "nearLavatory": 0, "nearWindow": 0, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 30.82, "adultAmount": 30.82, "childOriginalAmount": 30.82, "childAmount": 30.82 }, { "cabinClass": "Y", "rowNo": "17", "colNo": "D", "deck": "M", "status": 1, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 1, "nearExit": 0, "nearLavatory": 0, "nearWindow": 0, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 30.82, "adultAmount": 30.82, "childOriginalAmount": 30.82, "childAmount": 30.82 }, { "cabinClass": "Y", "rowNo": "17", "colNo": "E", "deck": "M", "status": 1, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 0, "nearExit": 0, "nearLavatory": 0, "nearWindow": 0, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 30.82, "adultAmount": 30.82, "childOriginalAmount": 30.82, "childAmount": 30.82 }, { "cabinClass": "Y", "rowNo": "17", "colNo": "F", "deck": "M", "status": 1, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 0, "nearExit": 0, "nearLavatory": 0, "nearWindow": 0, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 30.82, "adultAmount": 30.82, "childOriginalAmount": 30.82, "childAmount": 30.82 }, { "cabinClass": "Y", "rowNo": "17", "colNo": "G", "deck": "M", "status": 1, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 1, "nearExit": 0, "nearLavatory": 0, "nearWindow": 0, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 30.82, "adultAmount": 30.82, "childOriginalAmount": 30.82, "childAmount": 30.82 }, { "cabinClass": "Y", "rowNo": "17", "colNo": "H", "deck": "M", "status": 1, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 1, "nearExit": 0, "nearLavatory": 0, "nearWindow": 0, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 30.82, "adultAmount": 30.82, "childOriginalAmount": 30.82, "childAmount": 30.82 }, { "cabinClass": "Y", "rowNo": "46", "colNo": "K", "deck": "M", "status": 0, "data": "", "withInfant": 0, "allowChildSelected": 1, "overWing": 0, "nearAisle": 0, "nearExit": 0, "nearLavatory": 0, "nearWindow": 1, "originalCurrency": "USD", "currency": "USD", "adultOriginalAmount": 0.73, "adultAmount": 0.73, "childOriginalAmount": 0.73, "childAmount": 0.73 } ] } ] }, "contentStatus": 0, "contentMsg": "success" }
Status Code
| Name | Description |
|---|---|
| 1000 | General system error |
| 1001 | Request parameters or part of parameters missing |
| 1002 | Invalid Action |
| 1003 | API request timeout, please request again |
| 1004 | Invalid request parameter |
| 1005 | Service system error |
| 1006 | System busy, please try again |
| 1101 | Authentication fail, wrong signature |
| 1102 | Account disabled, please contact with account administrator |
| 2201 | No available seats data |
Error-Response
{ "status": 0, "msg": "success", "contentResponse":[ { "accountType": "2", "detail": { "content": "AK", "status": "0", "msg": "success" } }], }
Author：admin Create time：2023-05-24 16:06
Last editor：AeroHub Update time：2026-03-19 18:06
Last editor：AeroHub Update time：2026-03-19 18:06
