Booking | GetSeatAvailability

Get seat availability for a specific flight.

Notice:
Product Scope : TechHub

POST

/flight/booking

Parameter

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 3_letter number
  data required String Session data for AeroHub internal use, retrieve from AirPricing.
  depAirport required String Departure airport 3_letter number
  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": "n93mPT7WzN6cLKC2",
    "signature": "YhQ2EoBQOfOnf/EOnuuuK5i+K+ncydeQhjFpoXYiEMo=",
    "timestamp": 1685116516,
    "request": {
        "sessionId": "3b5d627ca8a9bbf094ca590e7bb3ae5f",
        "depTime": "202308300215",
        "depAirport": "TPE",
        "arrAirport": "KIX",
        "flightNumber": "MM030",
        "data": "eyJhaXJjcmFmdENvZGUiOiAiMzIwIiwgImxmX2lkIjogIjg3MTI5MCIsICJmYXJlX3NjaGVkdWx0X2lkIjogIjIwMjE2NyIsICJjYWJpbiI6ICJFQ09OT01ZIiwgImZjX2NvZGUiOiAiUyIsICJmYl9jb2RlIjogIlNIQVBQWSIsICJmYXJlX2lkIjogIjEifQ=="
    }
}

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
    items String[] items
      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 Whether seat is optional. 1 represent yes, 0 represent no
      withInfant Int Whether bring a infant:
0: Unknown
1: Yes
2: No
      allowChildSelected Int Whether child select seat.
1: Yes
0: No
2: Unknown
      data String encrypt data for AeroHub internal use

Success-Response

{
    "status": 0,
    "msg": "success",
    "seats": {
        "flightNumber": "VY8006",
        "depAirport": "BCN",
        "arrAirport": "ORY",
        "depTime": "202412051050",
        "aircraftCode": "",
        "seatCols": [
            {
                "deck": "M",
                "items": [
                    {
                        "cabinClass": "Y",
                        "rowNo": "1",
                        "colNo": "A",
                        "deck": "M",
                        "status": 0,
                        "data": "43e9933c6c8eb4f67d008eeca687eec5fptj0c7x",
                        "withInfant": 2,
                        "allowChildSelected": 1,
                        "overWing": 0,
                        "nearAisle": 2,
                        "nearExit": 0,
                        "nearLavatory": 0,
                        "nearWindow": 0,
                        "originalCurrency": "USD",
                        "currency": "USD",
                        "adultOriginalAmount": 63.55,
                        "adultAmount": 63.55,
                        "childOriginalAmount": 63.55,
                        "childAmount": 63.55
                    },
                    {
                        "cabinClass": "Y",
                        "rowNo": "1",
                        "colNo": "B",
                        "deck": "M",
                        "status": 0,
                        "data": "43e9933c6c8eb4f67d008eeca687eec5fptj0c7x",
                        "withInfant": 2,
                        "allowChildSelected": 1,
                        "overWing": 0,
                        "nearAisle": 2,
                        "nearExit": 0,
                        "nearLavatory": 0,
                        "nearWindow": 0,
                        "originalCurrency": "USD",
                        "currency": "USD",
                        "adultOriginalAmount": 40.25,
                        "adultAmount": 40.25,
                        "childOriginalAmount": 40.25,
                        "childAmount": 40.25
                    }
                ]
            }
        ]
    },
    "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：2025-04-22 14:25