AncillaryOrderDetail

  • Purpose: Used to obtain detailed information about a specified order, including all order statuses.
  • Request Method: POST
  • Interface Encryption: No
  • FareMarket Address：/supplier/v1/api/ancillary_order_detail

Request Parameters

Parameter Name Type Required Description
apiKey string ✅ Unique apiKey for each supplier, representing the supplier’s identity. Provided by AeroHub to the supplier before interface testing.
requestId string ✅ Request ID, unique for each call during the ticketing process, with a length of 32 characters.
ancillaryOrderNo string ✅ AeroHub’s ancillary order number, corresponding to AncillaryOrderNo used in the AncillaryOrderList interface request.

Request Example

{
    "apiKey": "PcrNq8964iFUkE0CyVV4bhgXXX",
    "requestId": "3fd720b5bf544161bd14c535c9",
    "ancillaryOrderNo": "F1745527321051406356"
}

Response Parameters

Parameter Name Type Required Description
code int ✅ AeroHub status code, refer to Market Errors in the general documentation.
msg string ✅ AeroHub error description, refer to Market Errors in the general documentation.
data object ⬜ Ancillary order details.

Data Object

Parameter Name Type Required Description
purchaseOrderNo string ✅ AeroHub’s ticket order number
ancillaryOrderNo string ✅ AeroHub’s ancillary order number
ancillaryOrderStatus string ✅ Ancillary order status: TOBEISSUED: Pending Issuance, ISSUED: Completed, REJECTED: Rejected (indicates ticketing failure)
totalCost float ✅ Total cost of ancillary sales
lastUpdateTime string ✅ Time of the last update of the order in the AeroHub system, using ISO 8601 format
createTime string ✅ Time when the order was created in the AeroHub system, using ISO 8601 format
ssr array/SSR Element ⬜️ Ancillary sales information after-sales
contact object/Contact Element ⬜️ Contact information for ancillary orders

object/Contact Element

Parameter Name Type Required Description
fullName string ✅ Full name of the contact person, separated by “/“, LastName/FirstName MiddleName
address string ✅ Contact address
postCode string ⬜️ Postal code
email string ✅ Email of the contact person
mobile string ✅ Mobile number of the contact person

array/SSR Element

Parameter Name Type Required Description
passengerNo int ✅ Passenger number
passengerName string ✅ Passenger name, separated by “/“, LastName/FirstName MiddleName
nationality string ✅ Passenger nationality, using ISO 3166 two-letter code as standard
birthday string ✅ Date of birth, format: YYYYMMDD
gender string ✅ Passenger gender, M for male, F for female
cardType int ✅ Type of identification: 0 Null, 1 Unknown, 2 Passport, 3 Hong Kong/Macau Pass, 4 Taiwan Pass, 5 Taiwan Compatriot Pass (Mainland Travel Permit for Taiwan Residents), 6 Home Return Permit (Mainland Travel Permit for Hong Kong/Macau Residents), 7 International Seafarer’s Certificate, 8 Identity Card
cardNo string ✅ Identification number, maximum 15 characters
cardExpired string ✅ Expiry date of identification, format: YYYYMMDD
ageType int ✅ Passenger type: 0 Adult, 1 Child, 2 Infant
flightNumber string ✅ Flight number
depAirport string ✅ Departure airport
arrAirport string ✅ Arrival airport
depTime string ✅ Date and time of departure (local time), using ISO 8601 format
arrTime string ✅ Date and time of arrival (local time), using ISO 8601 format
name string ✅ Ancillary service name
type int ✅ Ancillary service type: 0 Checked Baggage, 1 Carry-on Baggage, 2 Check-in, 3 for priority boarding&carry-on baggage.
code string ✅ Ancillary service code
weight int ✅ Weight
count int ✅ Quantity
bookSalePrice float ✅ Unit price
currency string ✅ Currency

Response example

Success-Response:

{
  "code": 200,
  "msg": "Success",
  "data": {
    "purchaseOrderNo": "333679914567",
    "ancillaryOrderNo": "A1772961465922359296",
    "ancillaryOrderStatus": “ISSUED”,
    "totalCost": 24.44,
    "lastUpdateTime": "2024-03-11T12:30:45",
    "createTime": "2024-03-10T15:45:20",
    "contact": {
        "fullName": "ZHANG/SAN",
        "address": "haugenlia 12447",
        "postCode": "10001",
        "email": "sansan@aerohub.uk",
        "mobile": "13801112547"
        },
    "ssr": [
      {
        "passengerNo": 0,
        "passengerName": "CHEN/RUKUN",
        "nationality": "PE",
        "birthday": "19650929",
        "gender": "F",
        "cardType": 2,
        "cardNo": "2230512125",
        "cardExpired": "20280327",
        "ageType": 0,
        "flightNumber": "DD123",
        "depAirport": "HKT",
        "arrAirport": "BKK",
        "depTime": "2023-01-12 03:25:22",
        "arrTime": "2023-01-12 03:25:22",
        "name": "15 KG",
        "type": 1,
        "code": "PA15",
        "weight": 15,
        "count": 2,
        "bookSalePrice": 12.22,
        "currency": "USD"
      }
    ]
  }
}

Error-Response

{
    "code": 1000,
    "msg": "Invalid API Key"
}
Author：AeroHub  Create time：2024-03-13 10:19
Last editor：AeroHub  Update time：2025-07-29 17:21