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: YYYYMMDD
  flightNumber required String Flight number, e.g. CA123
  sessionId required String SessionId，generated from AirPricing

Request_Example:

{
        "action": "GetSeatAvailability",
        "timestamp": 1685116516,
        "key": "mkAAABewq2YKiGEO26",
        "signature": "uaQb6MG71EAPTd2139AQmlSh//2GRB8zOxCAzWok2w=",
        "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
      amount String seat amount
      cabinClass String RBD code generated from airline
      rowNo String seat row no
      colNo String seat column no
      currency String currency
      deck String deck
      infant Int if passenger is infant. 1 represent yes, 0 represent no
      nearAisle Int if seat is near aisle. 1 represent yes, 0 represent no
      nearExit Int if seat is near the exit. 1 represent yes, 0 represent no
      nearLavatory Int if seat is near lavatory. 1 represent yes, 0 represent no
      nearWindow Int if seat is near window. 1 represent yes, 0 represent no
      originalAmount String originalAmount
      originalCurrency String originalCurrency
      overWing Int if seat is in overwing 1 represent yes, 0 represent no
      status Int if seat is optional. 1 represent yes, 0 represent 0
      withInfant Int if bring a infant. 1 represent yes, 0 represent no

Success-Response

{
    "contentMsg": "success",
    "contentStatus": 0,
    "msg": "success",
    "seats":
    {
        "aircraftCode": "320",
        "arrAirport": "KIX",
        "cabin": "",
        "depAirport": "ICN",
        "depTime": "202402230730",
        "flightNumber": "MM712",
        "seatCols":
        [
            {
                "floor": "M",
                "items":
                [
                    {
                        "amount": 19.32,
                        "cabinClass": "",
                        "colNo": "A",
                        "currency": "USD",
                        "data": "eyJzZXJ2aWNlQ29kZSI6ICJTVEZTIiwgInBoeXNpY2FsRmxpZ2h0SUQiOiAiODc0MjU4IiwgIm9yaWdpbmFsQW1vdW50IjogIjI0OTAwIn0=",
                        "deck": "M",
                        "infant": 0,
                        "nearAisle": 0,
                        "nearExit": 0,
                        "nearLavatory": 0,
                        "nearWindow": 0,
                        "originalAmount": 24900.0,
                        "originalCurrency": "KRW",
                        "overWing": 0,
                        "rowNo": "1",
                        "status": 0,
                        "withInfant": 0
                    },
                    {
                        "amount": 19.32,
                        "cabinClass": "",
                        "colNo": "B",
                        "currency": "USD",
                        "data": "eyJzZXJ2aWNlQ29kZSI6ICJTVEZTIiwgInBoeXNpY2FsRmxpZ2h0SUQiOiAiODc0MjU4IiwgIm9yaWdpbmFsQW1vdW50IjogIjI0OTAwIn0=",
                        "deck": "M",
                        "infant": 0,
                        "nearAisle": 0,
                        "nearExit": 0,
                        "nearLavatory": 0,
                        "nearWindow": 0,
                        "originalAmount": 24900.0,
                        "originalCurrency": "KRW",
                        "overWing": 0,
                        "rowNo": "1",
                        "status": 1,
                        "withInfant": 0
                    },
                    {
                        "amount": 19.32,
                        "cabinClass": "",
                        "colNo": "C",
                        "currency": "USD",
                        "data": "eyJzZXJ2aWNlQ29kZSI6ICJTVEZTIiwgInBoeXNpY2FsRmxpZ2h0SUQiOiAiODc0MjU4IiwgIm9yaWdpbmFsQW1vdW50IjogIjI0OTAwIn0=",
                        "deck": "M",
                        "infant": 0,
                        "nearAisle": 0,
                        "nearExit": 0,
                        "nearLavatory": 0,
                        "nearWindow": 0,
                        "originalAmount": 24900.0,
                        "originalCurrency": "KRW",
                        "overWing": 0,
                        "rowNo": "1",
                        "status": 1,
                        "withInfant": 0
                    },
                    {
                        "amount": 5.28,
                        "cabinClass": "",
                        "colNo": "E",
                        "currency": "USD",
                        "data": "eyJzZXJ2aWNlQ29kZSI6ICJTVFNEIiwgInBoeXNpY2FsRmxpZ2h0SUQiOiAiODc0MjU4IiwgIm9yaWdpbmFsQW1vdW50IjogIjY4MDAifQ==",
                        "deck": "M",
                        "infant": 0,
                        "nearAisle": 0,
                        "nearExit": 0,
                        "nearLavatory": 0,
                        "nearWindow": 0,
                        "originalAmount": 6800.0,
                        "originalCurrency": "KRW",
                        "overWing": 0,
                        "rowNo": "30",
                        "status": 1,
                        "withInfant": 0
                    },
                    {
                        "amount": 7.37,
                        "cabinClass": "",
                        "colNo": "F",
                        "currency": "USD",
                        "data": "eyJzZXJ2aWNlQ29kZSI6ICJTVFBMIiwgInBoeXNpY2FsRmxpZ2h0SUQiOiAiODc0MjU4IiwgIm9yaWdpbmFsQW1vdW50IjogIjk1MDAifQ==",
                        "deck": "M",
                        "infant": 0,
                        "nearAisle": 0,
                        "nearExit": 0,
                        "nearLavatory": 0,
                        "nearWindow": 0,
                        "originalAmount": 9500.0,
                        "originalCurrency": "KRW",
                        "overWing": 0,
                        "rowNo": "30",
                        "status": 1,
                        "withInfant": 0
                    }
                ]
            }
        ]
    },
    "status": 0
}

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：2024-09-10 16:26