Transfers

Transfers move funds between wallets within your company. Cross-currency transfers are supported with automatic FX conversion.

Create a transfer

POST /api/v1/transfer

{
  "from_wallet_id": "wal_abc123",
  "to_wallet_id": "wal_def456",
  "from_amount": 100000,
  "reference": "TRF-001",
  "description": "USD to EUR conversion"
}

For cross-currency transfers, the system automatically converts at the current exchange rate.

Get transfer details

GET /api/v1/transfer/{transfer_id}

Response

{
  "id": "trf_xyz789",
  "from_wallet_id": "wal_abc123",
  "to_wallet_id": "wal_def456",
  "from_amount": 100000,
  "from_currency_id": "USD",
  "to_amount": 92500,
  "to_currency_id": "EUR",
  "exchange_rate_from_to": 0.925,
  "status": "completed",
  "reference": "TRF-001",
  "created_at": "2026-06-01T10:30:00Z"
}

Transfer statuses

Status	Meaning
pending	Transfer initiated, being processed.
completed	Funds moved between wallets.
failed	Transfer failed — check the error field.

List transfers

GET /api/v1/transfers