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.

Use these endpoints to inspect balances before collecting, funding a working wallet, or initiating Send Money.

​
List wallets

curl --request GET \
  --url https://app.kulmipay.com/api/v1/wallets/ \
  --header "Authorization: Bearer ISSecretKey_live_xxxxxxxxxxxxxxxx"
The response returns wallet objects for your business: 
[
  {
    "wallet_id": "wlt_abc123",
    "label": "Settlement KES",
    "can_disburse": true,
    "currency": "KES",
    "wallet_type": "SETTLEMENT",
    "current_balance": "125000.00",
    "available_balance": "120000.00",
    "updated_at": "2026-05-28T09:30:00Z"
  }
]

​
Retrieve one wallet

curl --request GET \
  --url https://app.kulmipay.com/api/v1/wallets/wlt_abc123/ \
  --header "Authorization: Bearer ISSecretKey_live_xxxxxxxxxxxxxxxx"

​
Wallet fields

FieldDescription
wallet_idWallet alias ID. Use this in collection routing, transfers, and statements.
labelWallet display name.
can_disburseWhether the wallet can be used as a Send Money source wallet.
currencyWallet currency. One of KES, USD, EUR, GBP.
wallet_typeSETTLEMENT or WORKING.
current_balanceTotal wallet balance, including uncleared funds.
available_balanceBalance available for transfers and payouts.
updated_atLast wallet balance update timestamp.
You can filter the list endpoint by record_id, label, wallet_type, currency, can_disburse, or updated_at.