SSR

  • Purpose: Through this interface, you can obtain the price of the supplier’s auxiliary services, including checked baggage, boarding baggage, express boarding, etc.
  • 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

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
depDate str ✅ Departure date, format: YYYYMMDD, for example, 20230310 means March 10, 2023

Sample Request

{
    "requestId": "c0b0afec7ddd81a9cb3aa85713d39f36",
    "sessionId": "c80fbf1a15da1eceeeb70bb6e53105e9gvn52123",
    "segments": [{
        "depAirport": "CGY",
        "arrAirport": "MNL",
        "flightNumber": "5J378",
        "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
ssrs array/ssrs Element ✅ Baggage information for the flight segment
flightNumber string ✅ Flight number, such as: CA123
isDirect bool ✅ Whether the baggage is direct, true is direct, false is indirect, and needs to be checked in again.

array/ssrs Element

Parameter Name Type Required Description
applyType int ✅ Auxiliary operation type, 1 during reservation, 2 after reservation
name string ✅ Auxiliary camp name must be letters, numbers, or a combination of both. Other character formats are not supported.
code string ✅ Auxiliary code, please refer to the SSR Code Enum of this document for rules.
type int ✅ Auxiliary type, 0 checked baggage, 1 boarding baggage, 2 check-in, 3 boarding baggage + priority boarding package
bookSalePrice float ✅ Auxiliary operation price, rounded to 2 decimal places
currency string ✅ The auxiliary currency should be consistent with the ticket
weight int ✅ Baggage weight, unknown or no value can be assigned to 0
dimensions object/dimensions Element ⬜️ Specifications and models of auxiliary operations
unit string ✅ For the unit of measurement of the auxiliary operation, please pass KG for luggage, and please pass PC for check-in and express boarding.
desc string ✅ For the description of the auxiliary camp, please pass an empty string if there is no description.
maxCount int ⬜ Maximum purchase quantity of auxiliary business
weightChargeType string ⬜ The type corresponding to the weight of the auxiliary camp, “TOTAL” - indicates that the weight of the returned luggage is the total amount, “PER_WEIGHT” - indicates that the weight of the returned luggage is a single piece, if not returned, the default is: “PER_WEIGHT”

object/dimensions Element

Parameter Name Type Required Description
length int ✅ length of auxiliary camp
width int ✅ Auxiliary camp width
height int ✅ height of auxiliary camp

Response Example

Success Response:

{
    "marketErrorCode": 200,
    "marketErrorMsg": "Successful",
    "flights": [{
        "ssrs": [{
            "applyType": 1,
            "name": "40 KG",
            "code": "PA40",
            "type": 0,
            "bookSalePrice": 38.86,
            "currency": "USD",
            "weight": 40,
            "dimensions": {
                "length": 10,
                "width": 5,
                "height": 2
            },
            "unit": "KG",
            "desc": ""
        }, {
            "applyType": 1,
            "name": "25 KG",
            "code": "PA25",
            "type": 0,
            "bookSalePrice": 22.4,
            "currency": "USD",
            "weight": 25,
            "dimensions": {
                "length": 10,
                "width": 5,
                "height": 2
            },
            "unit": "KG",
            "desc": ""
        }],
        "flightNumber": "DD133",
        "isDirect": true
    }]
}

SSR Code Enum

  • The weight of the baggage is specified together with the code (for example, PA20 means 20 kilograms. If the airline has no weight specification, PA00 is passed)
Code Example definition describe
PA+Weight PA20 Checked baggage during booking This code is used by passengers to add checked baggage when booking
PB+Weight PB15 Check baggage after booking This code is used by passengers to add checked baggage after booking
CA+Weight CA10 Check-in baggage during booking This code is used by passengers to add carry-on (carry-on) baggage to their booking
CB+Weight CB10 Check-in baggage after booking This code is used by passengers to add check-in (carry-on) baggage after booking
PE00 PE00 Quick boarding during booking This code indicates that fast boarding is added when booking. If fast boarding is packed with other ancillary items such as boarding baggage, the value must be passed as fast boarding (for example: PE00)
PS00 PS00 Quick boarding after booking This code indicates that fast boarding is added after booking. If fast boarding is packed with other ancillary items such as boarding baggage, the value must be passed as fast boarding (for example: PS00)
Author：AeroHub  Create time：2023-11-10 17:01
Last editor：AeroHub  Update time：2026-10-20 11:28