AncillarySeat

  • Purpose: Used to retrieve supplier seat availability and prices for an AeroHub flight order after ticket issuance.
  • Request: POST
  • Encryption: No

Request

Parameter Name Type Required Description
requestId string ✅ Request ID. It must be unique for each call and must contain 32 characters.
orderNo string ⬜ AeroHub flight order number.
isCache int ⬜ Whether cached data should be used. Empty or 0: do not use cached data; 1: use cached data.
adultNumber int ✅ Number of adult passengers.
childNumber int ⬜ Number of child passengers.
infantNumber int ⬜ Number of infant passengers.
segments array/Segment Element ✅ Itinerary information.

array/Segment Element

Parameter Name Type Required Description
depAirport string ✅ Departure airport code, using the IATA three-letter code standard.
arrAirport string ✅ Arrival airport code, using the IATA three-letter code standard.
flightNumber string ✅ Flight number, for example 5J378.
segmentNo int ✅ Journey sequence: 1 for outbound and 2 for return.
sequence int ✅ Segment sequence, starting from 1. For a round trip, the outbound and return journeys each start from 1.
depDate string ✅ Departure date in YYYYMMDD format, for example 20240710.

Sample Request:

{
  "requestId": "74e155e75f9d4a33866cbd1234567890",
  "orderNo": "F123123123111121",
  "isCache": 0,
  "adultNumber": 1,
  "childNumber": 0,
  "infantNumber": 0,
  "segments": [
    {
      "depAirport": "CGY",
      "arrAirport": "MNL",
      "flightNumber": "5J378",
      "segmentNo": 1,
      "sequence": 1,
      "depDate": "20240710"
    }
  ]
}

Response

Parameter Name Type Required Description
marketErrorCode int ✅ Supplier system error code used to assist AeroHub and the supplier in troubleshooting. Return the actual error code.
marketErrorMsg string ✅ Supplier system error description. Return the actual reason, with a maximum length of 300 characters.
flights array/Flights Element ✅ Flight segment and seat information.

array/Flights Element

Parameter Name Type Required Description
flightNumber string ✅ Flight number, for example 5J378.
seats array/Seats Element ✅ Seat information for the flight segment. Return an empty array when no seats are available.

array/Seats Element

Parameter Name Type Required Description
amount float ✅ Seat selection price. An amount of 0 indicates that free seat selection is included in the package.
currency string ✅ Transaction currency.
rowNo string ✅ Seat row number.
colNo string ✅ Seat column number.
data string ✅ Raw supplier data used for internal business correlation, with a maximum length of 64 characters.
deck string ✅ Deck: M for Main Deck and U for Upper Deck.
status int ✅ Seat status: 0 unavailable, 1 available.
nearAisle int ✅ Whether the seat is near an aisle: 0 unknown, 1 yes, 2 no.
nearExit int ✅ Whether the seat is near an exit: 0 unknown, 1 yes, 2 no.
nearLavatory int ✅ Whether the seat is near a lavatory: 0 unknown, 1 yes, 2 no.
nearWindow int ✅ Whether the seat is near a window: 0 unknown, 1 yes, 2 no.
overWing int ✅ Whether the seat is over the wing: 0 unknown, 1 yes, 2 no.
allowChildSelected int ⬜ Whether a child may select the seat: 0 unknown, 1 yes, 2 no.
withInfant int ⬜ Whether a passenger traveling with an infant may select the seat: 0 unknown, 1 yes, 2 no.

Response Example

Success Response:

{
  "marketErrorCode": 200,
  "marketErrorMsg": "Successful",
  "flights": [
    {
      "flightNumber": "5J378",
      "seats": [
        {
          "amount": 29.32,
          "currency": "USD",
          "rowNo": "12",
          "colNo": "A",
          "data": "supplier-seat-token",
          "deck": "M",
          "status": 1,
          "nearAisle": 0,
          "nearExit": 0,
          "nearLavatory": 0,
          "nearWindow": 1,
          "overWing": 0,
          "allowChildSelected": 1,
          "withInfant": 0
        }
      ]
    }
  ]
}
Author：AeroHub  Create time：2026-10-20 11:16
Last editor：AeroHub  Update time：2026-10-20 11:28