SSR

  • Purpose: Retrieve prices for chargeable ancillaries from the supplier through this interface, including checked baggage, carry-on baggage, and priority boarding.
  • Request: POST
  • Encryption: No

Request

Name Type Required Description
requestId string ✅ Unique identifier for the request, ensuring uniqueness across various interfaces in the booking process. 32 characters in length.
sessionId string ✅ Session identifier for the supplier to link various interfaces in the booking process. Consists of alphanumeric characters, maximum length 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 codes as the standard.
arrAirport string ✅ Arrival airport code, using IATA three-letter codes as the standard.
flightNumber string ✅ Flight number, e.g., CA123.
depDate str ✅ Departure date, formatted as YYYYMMDD, e.g., 20230310 represents March 10, 2023.

Sample Request:

{
    "requestId": "74e155e75f9d4a33",
    "sessionId":"aNBOGd3p7Kf72ALZOQY",
    "segments": [{
        "depAirport": "CNX",
        "arrAirport": "DMK",
        "flightNumber": "DD133",
        "depDate": "20231226"
    }]
}

Response

Parameter Name Type Required Description
marketErrorCode int ✅ Supplier system error code, used to assist AeroHub and the supplier in troubleshooting issues. Please return the actual error faithfully.
marketErrorMsg string ✅ Supplier system error description. Please return the actual error reason, with a length 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 segment.
flightNumber string ✅ Flight number, e.g., CA123.
isDirect bool ✅ Whether the baggage is direct, true for direct, false for non-direct, requiring recheck.

array/ssrs Element

Parameter Name Type Required Description
applyType int ✅ Ancillary type, 1 for pre-booking, 2 for post-booking.
name string ✅ Ancillary name,must be letters, numbers, or a combination of both, other character formats are not supported
code string ✅ Ancillary code, refer to SSR Code Enum in this document for rules.
type int ✅ Ancillary type, 0 for checked baggage, 1 for carry-on baggage, 2 for check-in, 3 for priority boarding&carry-on baggage.
bookSalePrice float ✅ Ancillary price, with 2 decimal places.
currency string ✅ Ancillary currency, should match the ticket.
weight int ✅ Baggage weight, assign 0 if unknown or not applicable.
dimensions object/dimensions Element ⬜️ Ancillary dimensions.
unit string ✅ Ancillary unit of measurement, use ‘KG’ for baggage、use ‘PC’ for check-in or priority.
desc string ✅ Description for the ancillary.
maxCount int ⬜ Purchase limit

object/dimensions Element

Parameter Name Type Required Description
length int ✅ Ancillary length.
width int ✅ Ancillary width.
height int ✅ Ancillary height.

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
    }]
}

Error Response

{
    "marketErrorCode": 5118,
    "marketErrorMsg": "System error"
}

SSR Code Enum

  • Specify the baggage weight along with the code (e.g., PA20 for 20 kilograms; if the airline has no weight specifications, use PA00)
Code Example Definition Description
PA+Weight PA20 Pre-booking checked baggage This code is used for passengers to add checked baggage during booking.
PB+Weight PB15 Post-booking checked baggage This code is used for passengers to add checked baggage after booking.
CA+Weight CA10 Pre-booking carry-on baggage This code is used for passengers to add carry-on baggage during booking.
CB+Weight CB10 Post-booking carry-on baggage This code is used for passengers to add carry-on baggage after booking.
PE00 PE00 Pre-booking priority boarding This code indicates adding priority boarding during booking. If priority boarding is bundled with other ancillaries like carry-on baggage, the code remains the same. (e.g., PE00).
PS00 PS00 Post-booking priority boarding This code indicates adding priority boarding after booking. If priority boarding is bundled with other ancillaries like carry-on baggage, the code remains the same. (e.g., PS00).
Author：AeroHub  Create time：2023-11-10 17:01
Last editor：AeroHub  Update time：2025-07-29 17:21