GetSeat

  • Purpose: This API allows suppliers to provide seat selection pricing information.
  • Request Method: POST
  • Encryption: No

Request Parameters

Parameter Name Type Required Description
requestId string ✅ Unique request ID, used to connect different API calls in the booking process. Length: 32.
sessionId string ✅ Session identifier, used to link multiple API calls in the booking process. Max length: 40.
segments array/Segment Element ✅ Information about the travel segments.
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 (IATA three-letter code).
arrAirport string ✅ Arrival airport code (IATA three-letter code).
flightNumber string ✅ Flight number, e.g., CA123.
segmentNo int ✅ Trip sequence: 1 for outbound, 2 for return.
sequence int ✅ Segment sequence starting from 1 (resets for return trip).
depDate string ✅ Departure date in YYYYMMDD format (e.g., 20240710).

Request Example

{
    "requestId": "c0b0afec7ddd81a9cb3aa85713d39f36",
    "sessionId": "c80fbf1a15da1eceeeb70bb6e53105e9gvn52123",
    "adultNumber": 1,
    "segments": [
        {
            "depAirport": "CGY",
            "arrAirport": "MNL",
            "flightNumber": "5J378",
            "segmentNo": 1,
            "sequence": 1,
            "depDate": "20240710"
        }
    ]
}

Response Parameters

Parameter Name Type Required Description
marketErrorCode int ✅ Supplier system error code for debugging purposes.
marketErrorMsg string ✅ Supplier system error description. Max length: 300.
flights array/flights Element ✅ Travel and seat information.

array/flights Element

Parameter Name Type Required Description
seats array/seats Element ✅ Seat details for the segment.
flightNumber string ✅ Flight number, e.g., CA123.

array/seats Element

Parameter Name Type Required Description
amount float ✅ Seat selection price (0 indicates free selection included in the package).
currency string ✅ Currency for the transaction.
rowNo string ✅ Row number on the seat map.
colNo string ✅ Column number on the seat map.
data string ✅ Raw data for internal supplier use.
deck string ✅ M: Main deck, U: Upper deck.
status int ✅ 0: Unavailable, 1: Available.
nearAisle int ✅ 0: Unknown, 1: Yes, 2: No.
nearExit int ✅ 0: Unknown, 1: Yes, 2: No.
nearLavatory int ✅ 0: Unknown, 1: Yes, 2: No.
nearWindow int ✅ 0: Unknown, 1: Yes, 2: No.
overWing int ✅ 0: Unknown, 1: Yes, 2: No.
allowChildSelected int ⬜ 0: Unknown, 1: Yes, 2: No (indicates if children can select the seat).
withInfant int ⬜ 0: Unknown, 1: Yes, 2: No (indicates if infants are allowed for the seat).

Success Response Example

{
    "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
                }
            ]
        }
    ]
}
Author：AeroHub  Create time：2024-12-10 15:53
Last editor：AeroHub  Update time：2025-07-29 17:21