Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.kulmipay.com/llms.txt

Use this file to discover all available pages before exploring further.

Wallet transactions show credits, debits, charges, payouts, deposits, adjustments, and exchanges that affect a wallet balance.

​
Retrieve one wallet statement

curl --request GET \
  --url "https://app.kulmipay.com/api/v1/wallets/wlt_abc123/transactions/?start_date=2026-05-01&end_date=2026-05-28" \
  --header "Authorization: Bearer ISSecretKey_live_xxxxxxxxxxxxxxxx"

​
Retrieve transactions across wallets

curl --request GET \
  --url "https://app.kulmipay.com/api/v1/transactions/?wallet_id=wlt_abc123&trans_type=DEPOSIT" \
  --header "Authorization: Bearer ISSecretKey_live_xxxxxxxxxxxxxxxx"

​
Filters

FilterDescription
wallet_idWallet alias ID. Supported on GET /api/v1/transactions/.
currencyWallet currency, such as KES.
trans_typeTransaction type: SALE, ADJUSTMENT, PAYOUT, WITHDRAWAL, CHARGE, AIRTIME, DEPOSIT, EXCHANGE, or UNMARKED.
start_dateReturn transactions created on or after this date.
end_dateReturn transactions created on or before this date.
narrativeFilter by transaction narrative.

​
Transaction object

{
  "transaction_id": "txn_xyz789",
  "invoice": null,
  "currency": "KES",
  "value": "1500.00",
  "running_balance": "51500.00",
  "narrative": "Wallet funding",
  "trans_type": "DEPOSIT",
  "status": "AVAILABLE",
  "created_at": "2026-05-28T08:23:11Z",
  "updated_at": "2026-05-28T08:24:05Z"
}
invoice is present when the wallet transaction came from a collection invoice.