AncillaryOrderList

  • Purpose: Used to retrieve a list of pending ancillary orders within a specified time range and pull the order list.
  • Request Method: POST
  • Interface Encryption: No
  • FareMarket Address: /supplier/v1/api/ancillary_order_list

Request Parameters

Parameter Name Type Required Description
apiKey string ✅ Unique apiKey for each supplier, representing the supplier’s identity, provided by AeroHub before interface testing.
requestId string ✅ Request ID, unique for each call in the ticketing process, 32 characters in length.
beginDatetime string ✅ Start time for pulling the order list, in ISO 8601 format.
endDatetime string ✅ End time for pulling the order list, in ISO 8601 format.

Request Example

{
    "apiKey": "PcrNq8964iFUkE0CyVV4bhgXRH",
    "requestId": "3fd720b5bf544161bd14c535c9",
    "beginDatetime": "2023-01-11T09:17:17",
    "endDatetime": "2023-01-12T09:17:17"
}

Response Parameters

Parameter Name Type Required Description
code int ✅ AeroHub status code, refer to Market Errors in the general instructions.
msg string ✅ AeroHub error description, refer to Market Errors in the general instructions.
data array/Data Element ⬜️ Ancillary order list.

Data Element

Parameter Name Type Required Description
ancillaryOrderNo string ✅ AeroHub order number, corresponding to OrderNo in the Order interface request.
lastUpdateTime string ✅ Time of the last update of the order in the AeroHub system, in ISO 8601 format.
createTime string ✅ Time when the order was created in the AeroHub system, in ISO 8601 format.

Response Example

Success-Response:

{
    "code": 200,
    "msg": "Successful",
    "data": [{
        "ancillaryOrderNo": "A1745527321051406356",
        "purchaseOrderNo": "F1745527321051406356",
        "supplierOrderNo": "240112032518897783",
        "lastUpdateTime": "2023-01-12T03:25:19",
        "createTime": "2023-01-12T03:25:19"
            },
            {
        "ancillaryOrderNo": "A1745527321051406357",
        "orderNo": "F1745527321051406358",
        "supplierOrderNo": "240112032518897787",
        "lastUpdateTime": "2023-01-12T03:25:22",
        "createTime": "2023-01-12T03:25:21"
            }]
}

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