Wallet

List ledger entries

Every charge, credit and adjustment on your wallet, in pages, newest first.

GET/v1/wallet/ledger

Bearer tokenReturns JSONSuccess 200

runningBalance is the balance right after the entry. A mistake is never edited: it is corrected by a new entry. A postpaid account has no wallet, so its list is empty.

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.
`entryType`optional	`string`	Only this kind of entry: shipping_charge, insurance_premium, customs_duty_charge, cod_handling_fee, return_charge, refund, wallet_topup, cod_settlement, adjustment or correction.
`from`optional	`string`	On or after this time (ISO 8601, UTC).
`to`optional	`string`	On or before this time (ISO 8601, UTC).

Example request

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

Response

Example response · 200

{
  "rows": [
    {
      "id": "1408aa7e-be2f-4d31-a1ab-b9305935d02c",
      "entryType": "wallet_topup",
      "direction": "credit",
      "amount": "1000.00",
      "currency": "AED",
      "runningBalance": "1000.00",
      "description": "Wallet top-up",
      "reference": "TOPUP-2291",
      "orderId": null,
      "createdAt": "2026-10-02T02:28:45.558Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 25
}

Errors

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