Orders

List orders

Your orders, in pages, newest first, with filters.

GET/v1/orders

Bearer tokenReturns JSONSuccess 200

Filter by status, by created date, by destination and by your own reference. search matches the Order ID, air waybill number, your reference and the customer's name or mobile.

Request

Headers

Field	Type	Description
`Authorization`required	`string`	The access token from Get token, as "Bearer <token>".

Query parameters

Field	Type	Description
`page`optional	`number`	The page to return, starting at 1. Default 1.
`pageSize`optional	`10 \| 25 \| 50 \| 100`	Rows per page. Default 25.
`status`optional	`string`	A status code, from List order statuses.
`from`optional	`string`	On or after this time (ISO 8601, UTC).
`to`optional	`string`	On or before this time (ISO 8601, UTC).
`destinationCountryId`optional	`string`	Only orders going to this country.
`destinationCityId`optional	`string`	Only orders going to this city.
`reference`optional	`string`	Only the order with exactly this merchantReference.
`customerId`optional	`string`	Only orders of this customer.
`search`optional	`string`	Matches Order ID, air waybill number, your reference, customer name and mobile.

Example request

curl -X GET "https://api.swiftazu.com/v1/orders?page=1&pageSize=25" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

Example response · 200

{
  "rows": [
    {
      "id": "dffcd25d-6eb3-4b90-868c-6deca160ad74",
      "orderId": "SWZORDYFSADMR",
      "storeId": "100001",
      "merchantReference": "WEB-10482",
      "awbNumber": null,
      "status": {
        "code": "pending",
        "name": "Pending"
      },
      "subStatus": null,
      "isDemo": true,
      "isCrossBorder": false,
      "paymentMode": "prepaid",
      "codAmount": null,
      "orderTotal": "350.00",
      "shippingCharge": null,
      "boxCount": 1,
      "totalChargeableWeight": 1.8,
      "attemptCount": 0,
      "service": "Standard",
      "customer": {
        "fullName": "Layla Hassan",
        "mobile": "+971558250908"
      },
      "destination": {
        "city": "Dubai",
        "country": "United Arab Emirates"
      },
      "createdAt": "2026-10-02T02:30:51.260Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 25
}

Errors

Every call can also return the shared errors listed on the Overview page. Overview