Orders

Get order

One order in full: products, totals, charges and customs record.

GET/v1/orders/{orderId}

Bearer tokenReturns JSONSuccess 200

charges is empty until the order is dispatched. timeline lists each status once, at the time it was first reached.

Request

Headers

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

Path parameters

Field	Type	Description
`orderId`required	`string`	The order's id (the UUID, not the short Order ID).

Example request

curl -X GET "https://api.swiftazu.com/v1/orders/dffcd25d-6eb3-4b90-868c-6deca160ad74" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

Example response · 200

{
  "id": "dffcd25d-6eb3-4b90-868c-6deca160ad74",
  "orderId": "SWZORDYFSADMR",
  "storeId": "100001",
  "orderType": "manual",
  "merchantReference": "WEB-10482",
  "awbNumber": "DEMONQDJ3W6UDWML",
  "awbIssuedAt": "2026-10-02T02:30:51.709Z",
  "status": {
    "code": "ready_for_pickup",
    "name": "Ready for Pickup",
    "nameAr": "جاهز للاستلام"
  },
  "subStatus": null,
  "isDemo": true,
  "isCrossBorder": false,
  "service": {
    "id": "5c8e7ef4-e345-433f-baa7-43921d5a9332",
    "name": "Standard"
  },
  "paymentMode": "prepaid",
  "codAmount": null,
  "insuranceElected": true,
  "declaredValue": "350.00",
  "orderTotal": "350.00",
  "totalWeight": 1.4,
  "totalChargeableWeight": 1.8,
  "boxCount": 1,
  "charges": {
    "shippingCharge": "21.60",
    "insurancePremium": "5.00",
    "customsDutyCharge": null,
    "resolvedTier": 1,
    "originTier": 1,
    "ratedAt": "2026-10-02T02:30:51.709Z"
  },
  "customer": {
    "id": "8778df1e-9b74-420d-b826-d17cdad86d36",
    "fullName": "Layla Hassan",
    "mobile": "+971558250908",
    "email": "layla.hassan@example.com"
  },
  "delivery": {
    "contactName": "Layla Hassan",
    "altPhone": null,
    "instructions": "Leave with reception",
    "address": {
      "formattedAddress": "Burj Views B, Downtown Dubai",
      "buildingUnit": "Apt 1203",
      "postalCode": null,
      "countryId": "cfde4319-9563-4d6a-9afa-0f72dad3c718",
      "country": "United Arab Emirates",
      "stateId": "73ff99bd-ca0e-4ec7-a60e-f314c57c0046",
      "state": "Dubai",
      "cityId": "23a058c2-9b96-460b-92d8-1196cba2f562",
      "city": "Dubai",
      "latitude": null,
      "longitude": null,
      "customFieldValues": {}
    }
  },
  "pickup": {
    "address": {
      "id": "899caca3-0471-423e-9a90-0add12d7355b",
      "name": "Al Quoz warehouse"
    },
    "requestedFrom": null,
    "requestedTo": null
  },
  "attemptCount": 0,
  "boxes": [
    {
      "id": "4f18d6e3-847b-449f-a523-8a35308851a7",
      "position": 1,
      "barcode": "DEMONQDJ3W6UDWML-1",
      "standardBoxId": null,
      "length": 30,
      "width": 20,
      "height": 15,
      "actualWeight": 1.4,
      "volumetricWeight": 1.8,
      "chargeableWeight": 1.8,
      "boxTotal": "350.00",
      "isFragile": false,
      "isLiquid": false,
      "isBattery": false,
      "isPerishable": false,
      "isOversize": false,
      "items": [
        {
          "id": "ba8cf455-cc34-4a1c-bbe4-7110a2ce566a",
          "productName": "Linen shirt",
          "sku": "LS-001",
          "quantity": 2,
          "unitPrice": "120.00",
          "unitWeight": 0.4,
          "rowTotal": "240.00",
          "rowWeight": 0.8,
          "hsCode": null,
          "originCountryId": null,
          "unitOfMeasure": null,
          "declaredCurrency": null
        }
      ]
    }
  ],
  "customs": null,
  "timeline": [
    {
      "code": "pending",
      "name": "Pending",
      "reachedAt": "2026-10-02T02:30:51.260Z"
    },
    {
      "code": "ready_for_pickup",
      "name": "Ready for Pickup",
      "reachedAt": "2026-10-02T02:30:51.709Z"
    }
  ],
  "createdAt": "2026-10-02T02:30:51.260Z",
  "updatedAt": "2026-10-02T02:30:51.709Z"
}

Errors

HTTP	Code	Meaning
404	`not_found`	The record does not exist, or it is not yours.

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