Verify

  • Purpose: Used to verify whether the airline ticket prices have changed, ensuring the accuracy of prices during the booking process.
  • Request: POST
  • Encryption: No

Request

Parameter Name Type Required Description
requestId string ✅ Request ID, unique for each interface in the booking process. This field links the entire booking process together, 32 characters long.
tripType int ✅ Trip type: 1 for one-way, 2 for round-trip.
adultNumber int ✅ Number of adult passengers.
childNumber int ⬜ Number of child passengers.
infantNumber int ⬜ Number of infant passengers.
routing object/routing Element ✅ Used to record itinerary information.
siteChannel int ⬜ Site source, each site has different service requirements. For example, 1 represents site1.

object/routing Element

Parameter Name Type Required Description
data string ✅ The raw data returned by the search interface, used for internal business linking by the supplier.
fromSegments array/Segment Element ✅ Outbound flight itinerary information.
retSegments array/Segment Element ⬜ Return flight itinerary information.
packageInfo object/packageInfo Element ⬜ Package information, reference the packageInfo element in the search interface.

array/Segment Element

Parameter Name Type Required Description
marketingCarrier string ✅ Airline carrier code, using the IATA two-letter code standard, matching the first two letters of the flight number.
depAirport string ✅ Departure airport code, using the IATA three-letter code standard.
depTime string ✅ Departure date and time (local time), format: YYYYMMDDHHMM. For example, 202303100300 means 03:00 on March 10, 2023.
arrAirport string ✅ Arrival airport code, using the IATA three-letter code standard.
arrTime string ✅ Arrival date and time (local time), format: YYYYMMDDHHMM. For example, 202303101305 means 13:05 on March 10, 2023.
seatGrade string ✅ Seat class: F (First Class), C (Business Class), S (Premium Economy), Y (Economy Class).
seatClass string ✅ Seat type.
flightNumber string ✅ Flight number, e.g., CA123.
codeShare bool ✅ Indicates whether the flight is a codeshare: true (codeshare), false (not a codeshare). If true, operatingCarrier and operatingFlightNo must be returned.
aircraftCode string ⬜ Aircraft type, using the IATA three-letter code standard.
segmentNo int ⬜ Segment order: 1 for outbound, 2 for return.
operatingCarrier string ⬜ Operating carrier airline code, using the IATA two-letter code standard, matching the first two letters of the operating flight number.
operatingFlightNo string ⬜ Operating flight number.
stopCities string ⬜ Stopover cities, separated by /, using the ISO 3166 three-letter code standard.
stopAirports string ⬜ Stopover airports, separated by /, using the ISO 3166 three-letter code standard.

Sample Request:

{
    "requestId": "74e155e75f9d4a33",
    "tripType": 2,
    "adultNumber": 1,
    "childNumber": 0,
    "infantNumber": 0,
    "routing": {
        "data": "DST_djlfOUNCMkNCSl9QVkdoU2l0ZV9fX18w",
        "fromSegments": [{
            "marketingCarrier": "9C",
            "depAirport": "PVG",
            "depTime": "202302100915",
            "arrAirport": "HKG",
            "arrTime": "202302101220",
            "seatGrade": "",
            "seatClass": "V",
            "flightNumber": "9C8921",
            "codeShare": false,
            "aircraftCode": "",
            "segmentNo": 1,
            "operatingCarrier": "",
            "operatingFlightNo": "",
            "stopCities": "",
            "stopAirports": ""
        }],
        "retSegments": [{
            "marketingCarrier": "9C",
            "depAirport": "HKG",
            "depTime": "202302151320",
            "arrAirport": "PVG",
            "arrTime": "202302151545",
            "seatClass": "V",
            "seatGrade": "",
            "flightNumber": "9C8922",
            "codeShare": false,
            "aircraftCode": "",
            "segmentNo": 2,
            "operatingCarrier": "",
            "operatingFlightNo": "",
            "stopCities": "",
            "stopAirports": ""
        }],
        "packageInfo":null
    },
    "siteChannel": ""
}

Response

Parameter Name Type Required Description
marketErrorCode int ✅ Supplier system error code, used to assist AeroHub in troubleshooting with the supplier. Please return the actual error.
marketErrorMsg string ✅ Supplier system error description, please return the actual error reason, length less than 300.
sessionId string ✅ Session identifier, a unique identifier for linking various interfaces in the booking process, consisting of numbers or letters, maximum length of 40 characters.
maxSeats int ✅ Maximum number of seats available for booking, up to 9, cannot be less than the number of people in the price request.
routing object/routing Element ✅ Itinerary information returned from the price check.

object/routing Element

Parameter Name Type Required Description
data string ✅ Used by the supplier for internal purposes, stores necessary information. The original data from the price verification request will be passed back to the supplier when placing the order.
fromSegments array/Segment Element ✅ Outbound flight itinerary information, refer to the request.
retSegments array/Segment Element ⬜ Return flight itinerary information, refer to the request.
priceList array/priceList Element ✅ Ticket prices for different passenger types, refer to the search interface.
eligibility string ⬜ Passenger identity code: NOR (Normal Adult), LAB (Labor Worker), SEA (Seafarer), SNR (Senior), STU (Student), YOU (Youth).
validatingCarrier string ✅ Airline code of the actual ticket issuer, using the IATA two-letter code standard.
productType string ⬜ Product type. If not filled, represents standard products (refund and change rules are subject to the airline’s regulations). Currently, AeroHub only offers standard products.
fareBasis string ⬜ Corresponding fare class in GDS, one for each segment, separated by “;” if multiple.
bookingOfficeNo string ⬜ Booking office number, reserved field for AeroHub, currently can be left empty.
ticketingOfficeNo string ⬜ Ticketing office number, reserved field for AeroHub, currently can be left empty.
reservationType string ⬜ Policy source, reserved field for AeroHub, currently can be left empty.
posCode string ⬜ Ticketing country code, using the ISO 3166 two-letter code standard. Multiple ticketing locations separated by “|”.
complexTerm int ⬜ Special product reserved field, currently no special products in AeroHub, this field can be 0.
minAge int ⬜ Minimum age requirement for this flight, 0 means no restriction.
maxAge int ⬜ Maximum age requirement for this flight, 0 means no restriction.
planCategory int ⬜ Reserved field for AeroHub.
invoiceType string ✅ Available ticket voucher types, T (Itinerary), F (Invoice), E (Electronic Invoice).
minPassengerCount int ⬜ Minimum number of passengers for this flight, starting from 1.
maxPassengerCount int ⬜ Maximum number of passengers for this flight.
note string ⬜ Notes, maximum 300 characters.
airlineAncillaries object/airlineAncillaries Element ⬜ Baggage information, reflecting whether baggage can be sold and if free baggage is included, refer to the search interface.
formatBaggageDetailList array/formatBaggageDetailList Element ⬜ Baggage details in the package, refer to the search interface.
refundInfoList array/refundInfoList Element ⬜ Refund rules, refer to the search interface.
changesInfoList array/changesInfoList Element ⬜ Change rules, refer to the search interface.
packageInfo object/packageInfo Element ⬜ Package information, refer to the search interface.
currency string ✅ Currency of the quote, typically matches the settlement currency agreed with the supplier.
ticketTimeUnit int ⬜ Ticketing duration in seconds, used to match AeroHub’s ticketing requirements for different products. The returned value will be prioritized for price comparison.
combineIndexs array ⬜ Quotation concatenation point, reserved field for AeroHub, currently unused, can be left empty.
endorsement int ⬜ Whether endorsement is supported, 0 means not supported, 1 means supported.

Success Response:

{
    "marketErrorCode": 200,
    "marketErrorMsg": "Successful",
    "sessionId": "aNBOGd3p7Kf72ALZOQY",
    "maxSeats": 9,
    "routing": {
        "data": "DST_djlfOUNCMkNCSl9QVkdfSEtHXzIwMj",
        "fromSegments": [{
            "marketingCarrier": "9C",
            "depAirport": "PVG",
            "depTime": "202302100915",
            "arrAirport": "HKG",
            "arrTime": "202302101220",
            "seatGrade": "",
            "seatClass": "V",
            "flightNumber": "9C8921",
            "codeShare": false,
            "aircraftCode": "",
            "segmentNo": 1,
            "operatingCarrier": "",
            "operatingFlightNo": "",
            "stopCities": "",
            "stopAirports": ""
        }],
        "retSegments": [{
            "marketingCarrier": "9C",
            "depAirport": "HKG",
            "depTime": "202302151320",
            "arrAirport": "PVG",
            "arrTime": "202302151545",
            "seatClass": "V",
            "seatGrade": "",
            "flightNumber": "9C8922",
            "codeShare": false,
            "aircraftCode": "",
            "segmentNo": 2,
            "operatingCarrier": "",
            "operatingFlightNo": "",
            "stopCities": "",
            "stopAirports": ""
        }],
        "priceList": [{
            "passengerType": 0,
            "publishPrice": 0,
            "price": 608,
            "taxFeeAmount": 369,
            "taxFeeDisclosureList": []
        },
        "eligibility": "NOR",
        {
            "passengerType": 1,
            "publishPrice": 0,
            "price": 608,
            "taxFeeAmount": 369,
            "taxFeeDisclosureList": []
        }],
        "validatingCarrier": "9C",
        "productType": "",
        "fareBasis": "",
        "bookingOfficeNo": "",
        "ticketingOfficeNo": "",
        "reservationType": "",
        "posCode": "",
        "complexTerm": 0,
        "minAge": 0,
        "maxAge": 0,
        "planCategory": 0,
        "invoiceType": "E",
        "minPassengerCount": 1,
        "maxPassengerCount": 9,
        "note": "xxx",
        "airlineAncillaries": {
            "baggageService": true,
            "unFreeBaggage": true
        },
        "formatBaggageDetailList": [],
        "refundInfoList": [{
            "passengerType": 0,
            "refundType": 0,
            "refundStatus": "T",
            "refundFee": 0,
            "refNoshow": "T",
            "refNoShowCondition": 0,
            "refNoshowFee": 0,
            "conditionList": []
        },
        {
            "passengerType": 1,
            "refundType": 0,
            "refundStatus": "T",
            "refundFee": 0,
            "refNoshow": "T",
            "refNoShowCondition": 0,
            "refNoshowFee": 0,
            "conditionList": []
        }],
        "changesInfoList": [{
            "passengerType": 0,
            "changesType": 0,
            "changesStatus": "T",
            "changesFee": 0,
            "revNoshow": "T",
            "revNoShowCondition": 0,
            "revNoshowFee": 0,
            "conditionList": ""
        },
        {
            "passengerType": 1,
            "changesType": 0,
            "changesStatus": "T",
            "changesFee": 0,
            "revNoshow": "T",
            "revNoShowCondition": 0,
            "revNoshowFee": 0,
            "conditionList": ""
        }],
        "packageInfo": null,
        "currency": "USD",
        "ticketTimeUnit": 1000,
        "combineIndexs": [],
        "endorsement": 0
    }
}

Error Response

{
    "marketErrorCode": 5118,
    "marketErrorMsg": "System error"
}
Author：AeroHub  Create time：2023-07-10 16:10
Last editor：AeroHub  Update time：2025-07-29 17:21