WalletsTransactions

Transaction History

List, filter, and paginate through wallet transaction history. Build transaction feeds, export statements, or power analytics dashboards.

Embedded Wallet transactions

For creating transfers, holds, and releases between wallets, see the Embedded Wallet API documentation. This page covers the read-only transaction listing endpoint.

List transactions

Retrieve the transaction history for a specific wallet with filtering and pagination.

GET/wallets/{wallet_id}/transactions

List transactions for a wallet with optional filters.

Query parameters

Name	Type	Required	Description
currency	string	optional	Filter by currency code (e.g., "IQD", "USD").
type	string	optional	Filter by type: "credit", "debit", "hold", "release", "fx".
from	string	optional	Start date in ISO 8601 format (e.g., "2025-01-01T00:00:00Z").
to	string	optional	End date in ISO 8601 format.
page	integer	optional	Page number. Default: 1.
per_page	integer	optional	Results per page (max 100). Default: 20.

# List recent IQD transactions
curl "https://wallet.e-mazad.store/api/v1/wallets/wal_abc123/transactions?currency=IQD&per_page=10" \
  -H "Authorization: Bearer sk_sandbox_..."

# Filter by date range
curl "https://wallet.e-mazad.store/api/v1/wallets/wal_abc123/transactions?from=2025-03-01T00:00:00Z&to=2025-03-31T23:59:59Z" \
  -H "Authorization: Bearer sk_sandbox_..."

Transaction types

Each transaction has a type that indicates the nature of the balance change.

Type	Effect	Description
credit	Increases available	Funds received (payment, transfer in, release, refund)
debit	Decreases available	Funds sent (transfer out, subscription charge, payout)
hold	Moves to held	Funds reserved for escrow (decreases available, increases held)
release	Moves from held	Hold released back to available balance
fx	Converts currency	FX conversion: debits one currency, credits another

Reference types

The reference_type and reference_id fields link each transaction back to the originating operation.

Reference type	ID prefix	Description
payment	pay_	Payment gateway transaction
transfer	txf_	Wallet-to-wallet transfer
hold	hld_	Escrow hold operation
subscription	sub_	Subscription billing charge
payroll	batch_	Payroll batch payout
fx	fx_	Foreign exchange conversion
refund	ref_	Payment or hold refund

Balances FX