Swiftazu

Tracking

Get tracking

The full event history and the customer-facing timeline of one order.

GET/v1/orders/{orderId}/tracking
Bearer tokenReturns JSONSuccess 200

events holds every status change and scan in the order it happened. timeline holds each customer-visible status once, at the time it was first reached.

Request

Headers

FieldTypeDescription
AuthorizationrequiredstringThe access token from Get token, as "Bearer <token>".

Path parameters

FieldTypeDescription
orderIdrequiredstringThe 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/tracking" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

Example response · 200
{
  "id": "dffcd25d-6eb3-4b90-868c-6deca160ad74",
  "orderId": "SWZORDYFSADMR",
  "awbNumber": "DEMONQDJ3W6UDWML",
  "merchantReference": "WEB-10482",
  "isDemo": true,
  "status": {
    "code": "picked_up",
    "name": "Picked Up",
    "nameAr": "تم الاستلام",
    "isTerminal": false
  },
  "subStatus": null,
  "destination": {
    "city": "Dubai",
    "country": "United Arab Emirates"
  },
  "boxCount": 1,
  "attemptCount": 0,
  "updatedAt": "2026-10-02T02:30:52.216Z",
  "events": [
    {
      "id": "eac7453b-76b0-4c00-81be-48fbbcc47901",
      "status": {
        "code": "pending",
        "name": "Pending"
      },
      "subStatus": null,
      "actorType": "merchant",
      "notes": null,
      "occurredAt": "2026-10-02T02:30:51.260Z",
      "correctionOf": null
    },
    {
      "id": "f307be27-0938-4da6-a90d-186ec12b84b2",
      "status": {
        "code": "ready_for_pickup",
        "name": "Ready for Pickup"
      },
      "subStatus": null,
      "actorType": "merchant",
      "notes": null,
      "occurredAt": "2026-10-02T02:30:51.709Z",
      "correctionOf": null
    },
    {
      "id": "be27c7d3-4e21-4ed3-9f7f-febe82117b3b",
      "status": {
        "code": "picked_up",
        "name": "Picked Up"
      },
      "subStatus": null,
      "actorType": "driver",
      "notes": null,
      "occurredAt": "2026-10-02T02:30:52.216Z",
      "correctionOf": null
    }
  ],
  "timeline": [
    {
      "code": "pending",
      "name": "Pending",
      "nameAr": "قيد الانتظار",
      "reachedAt": "2026-10-02T02:30:51.260Z"
    },
    {
      "code": "ready_for_pickup",
      "name": "Ready for Pickup",
      "nameAr": "جاهز للاستلام",
      "reachedAt": "2026-10-02T02:30:51.709Z"
    },
    {
      "code": "picked_up",
      "name": "Picked Up",
      "nameAr": "تم الاستلام",
      "reachedAt": "2026-10-02T02:30:52.216Z"
    }
  ]
}

Errors

HTTPCodeMeaning
404order_not_foundNo order of yours has this id or air waybill number.

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