GetSeat

  • Purpose: Through this interface, you can obtain the price of seat selection charged by the supplier.
  • Request: POST
  • Encryption: No

Request

Parameter Name Type Required Description
requestId string ✅ Request ID. Each interface in the booking process is unique. A complete booking process can be connected through this field. The length is 32 bits.
sessionId string ✅ Session ID, the supplier’s unique ID for each interface connected in series during the reservation process, consisting of numbers or letters, with a maximum length of 40 characters
segments array/Segment Element ✅ Itinerary information
adultNumber int ✅ Number of adult passengers
childNumber int ⬜ Number of child passengers
infantNumber int ⬜ Number of infant passengers

array/Segment Element

Parameter Name Type Required Description
depAirport string ✅ Departure airport code, using IATA three-letter code as the standard
arrAirport string ✅ Arrival airport code, using IATA three-letter code as the standard
flightNumber string ✅ Flight number, such as: CA123
segmentNo int ✅ Flight sequence, 1 outbound trip, 2 return trip
sequence int ✅ The sequence of flight segments starts from 1. Note: If it is a round trip, both the outbound and return journeys start from 1.
depDate string ✅ Departure date, format: YYYYMMDD, for example, 20230310 means March 10, 2023

Sample Request

{
    "requestId": "c0b0afec7ddd81a9cb3aa85713d39f36",
    "sessionId": "c80fbf1a15da1eceeeb70bb6e53105e9gvn52123",
    "adultNumber": 1,
    "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 is used to assist AeroHub and suppliers in troubleshooting problems. Please return the true error truthfully.
marketErrorMsg string ✅ Supplier system error description, please truthfully return the real error reason, the length is less than 300 characters
flights array/flights Element ✅ Itinerary and baggage information

array/flights Element

Parameter Name Type Required Description
seats array/seats Element ✅ Seat information for flight segments
flightNumber string ✅ Flight number, such as: CA123

array/seats Element

Parameter Name Type Required Description
amount float ✅ The price of seat selection, the amount is 0, represents the free seat selection included in the package
currency string ✅ Transaction currency
rowNo string ✅ Seat map row number
colNo string ✅ Seating map row number
data string ✅ The original data returned is used for suppliers to do internal business. The serial length does not exceed 64 bits.
deck string ✅ M: MainDeck lower deck; U: UpperDeck upper deck.
status int ✅ 0 is not optional, 1 is optional
nearAisle int ✅ Is it close to the corridor 0: Unknown 1: Yes 2: No
nearExit int ✅ Whether by exit 0: Unknown 1: Yes 2: No
nearLavatory int ✅ Whether it depends on the toilet 0: Unknown 1: Yes 2: No
nearWindow int ✅ Whether by a window 0: Unknown 1: Yes 2: No
overWing int ✅ Whether on the wing 0: Unknown 1: Yes 2: No
allowChildSelected int ⬜ Whether children are allowed to choose their seats 0: Unknown 1: Yes 2: No
withInfant int ⬜ Whether the current seat allows infants to be carried 0: Unknown 1: Yes 2: No

Response Example

Success Response:

{
    "marketErrorCode": 200,
    "marketErrorMsg": "Successful",
    "flights": [{
        "flightNumber": "5J378",
        "seats": [
             {
                "amount": 0.0,
                "currency": "USD",
                "rowNo": "1",
                "colNo": "A",
                "data": "eyJzZXJ2aWNlQ29kZSI6ICJTVEZTIiwgI0=",
                "deck": "M",
                "status": 0,
                "nearAisle": 0,
                "nearExit": 0,
                "nearLavatory": 0,
                "nearWindow": 0,
                "overWing": 0,
                "allowChildSelected": 0,
                "withInfant": 0
            },
            {
                "amount": 29.32,
                "currency": "USD",
                "rowNo": "2",
                "colNo": "A",
                "data": "eyJzZXJ2aWNlQ29kZSI6IvdogIjI0OTAwIn0=",
                "deck": "M",
                "status": 1,
                "nearAisle": 0,
                "nearExit": 0,
                "nearLavatory": 0,
                "nearWindow": 0,
                "overWing": 0,
                "allowChildSelected": 0,
                "withInfant": 0
            },
            {
                "amount": 29.32,
                "currency": "USD",
                "rowNo": "3",
                "colNo": "A",
                "data": "eyJzZXJ2aWNlQ29kjI0OTAwIn0=",
                "deck": "M",
                "status": 1,
                "nearAisle": 0,
                "nearExit": 0,
                "nearLavatory": 0,
                "nearWindow": 0,
                "overWing": 0,
                "allowChildSelected": 0,
                "withInfant": 0
            },
            {
                "amount": 39.32,
                "currency": "USD",
                "rowNo": "1",
                "colNo": "B",
                "data": "eyJzZXJ2aWNlQ29kZZ2h0dpbI0OTAwIn0=",
                "deck": "U",
                "status": 1,
                "nearAisle": 0,
                "nearExit": 0,
                "nearLavatory": 0,
                "nearWindow": 0,
                "overWing": 0,
                "allowChildSelected": 0,
                "withInfant": 0
            }
        ]
    }]
}
Author：AeroHub  Create time：2024-12-10 15:53
Last editor：AeroHub  Update time：2026-10-20 11:28