OrderList

  • Purpose: Used to obtain a list of orders within a specified time range
  • Request: POST
  • Encryption: No
  • FareMarket address:/supplier/v2/api/order_list

Request

Parameter Name Type Required Description
apiKey string ✅ Each supplier has its own unique apiKey, which is used to indicate the supplier’s identity. AeroHub provides it to the supplier before interface testing.
requestId string ✅ Request ID, which is unique for each call in the ticket issuance process and has a length of 32 digits.
beginDatetime string ✅ The starting time when the order list is pulled, in ISO 8601 format
endDatetime string ✅ The end time when pulling the order list, in ISO 8601 format

Sample Request

{
    "apiKey": "PcrNq8964iFUkE0CyVV4bhgXXX",
    "requestId": "3fd720b5bf544161bd14c535c9",
    "beginDatetime": "2023-01-11T09:17:17+08:00",
    "endDatetime": "2023-01-12T09:17:17+08:00"
}

Response

Parameter Name Type Required Description
code int ✅ For the status code of AeroHub, refer to Market Errors in the general instructions.
msg string ✅ For AeroHub error instructions, refer to Market Errors in General Instructions.
data array/Data Element ⬜️ Order list data

Data Element

Parameter Name Type Required Description
purchaseOrderNo string ✅ The order number of AeroHub corresponds to the OrderNo when requesting the Order interface.
supplierOrderNo string ✅ The order number of the supplier’s own system corresponds to the OrderNo returned by the Order interface.

Response Example

Success Response:

{
    "code": 200,
    "msg": "Successful",
    "data": [{
        "purchaseOrderNo": "F1745527321051406356",
        "supplierOrderNo": "240112032518897783"
        },
        {
        "purchaseOrderNo": "F1745527321051406357",
        "supplierOrderNo": "240112032518897784"
        }
    ]
}

Error Response

{
    "code": 1000,
    "msg": "Invalid API Key"
}

Things to note

  • When encountering the returned JSON data code When not equal to 200 or the HTTP status code is non-200, the provider needs to retry the call to ensure successful processing of the request.
Author：AeroHub  Create time：2024-03-15 15:13
Last editor：AeroHub  Update time：2026-10-20 11:28