Returns

List returns

Your returns with their status.

GET/v1/returns

Bearer tokenReturns JSONSuccess 200

Request

Headers

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

Query parameters

Field	Type	Description
`status`optional	`string`	initiated, return_to_origin, at_hub, out_for_return, returned or partially_returned.
`search`optional	`string`	Matches the air waybill number or the Order ID.
`city`optional	`string`	Only returns from this destination city (by name).
`reasonCodeId`optional	`string`	Only returns with this reason.

Example request

curl -X GET "https://api.swiftazu.com/v1/returns" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

Example response · 200

[
  {
    "id": "b980e9e3-eb45-432c-ad72-2fb1a9946213",
    "orderId": "SWZORDYFSADMR",
    "awbNumber": "DEMONQDJ3W6UDWML",
    "status": "initiated",
    "reason": null,
    "reasonCode": null,
    "customer": "Layla Hassan",
    "city": "Dubai",
    "boxCount": 1,
    "boxesReturned": 0,
    "returnCharge": null,
    "currency": "AED",
    "confirmedAt": null,
    "createdAt": "2026-10-02T02:30:52.395Z"
  }
]

Errors

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