Skip to main content

Transfer

A same-currency transfer between two wallets of the account

transferIdstring<uuid>

Unique identifier of the transfer

fromWalletIdstring<uuid>

Wallet debited

toWalletIdstring<uuid>

Wallet credited

amountstring

Amount moved, as a decimal string

Example: 250.00
currencystring

Currency of both wallets

Example: AED
referencestring | nullnullable

Reference shown on both wallets' entries

Example: Sweep to pooled account
externalIdstring | nullnullable

Your own reference for the transfer

Example: sweep-2026-10-16-42
statusstring

Lifecycle status of the transfer

Possible values: [PENDING, EXECUTED, REJECTED, FAILED]

createdAtstring<date-time>

When the transfer was created, UTC

completedAt(string | null)<date-time>nullable

When the transfer reached EXECUTED, REJECTED or FAILED, UTC. Absent while PENDING

Transfer
{
  "transferId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "fromWalletId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "toWalletId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "amount": "250.00",
  "currency": "AED",
  "reference": "Sweep to pooled account",
  "externalId": "sweep-2026-10-16-42",
  "status": "PENDING",
  "createdAt": "2024-07-29T15:51:28.071Z",
  "completedAt": "2024-07-29T15:51:28.071Z"
}