API ReferenceCurrent account
Open Current Account Legacy
curl -X POST "https://example.com/v1/me/current-account"{ "id": "550e8400-e29b-41d4-a716-446655440000", "resource_id": "acc_2n1t201rmv87aae5j4csam8000", "account_number": "00123455", "user_id": "660e8400-e29b-41d4-a716-446655440111", "external_account_number": "1234567890", "external_account_id": "1234567890", "external_provider": "CHOICE", "wallet_onboarding_status": "ACCOUNT_OPENED", "wallet_onboarding_rejection_reasons": [], "onboarding_status": "ACTIVE", "onboarding_rejection_reasons": [], "activatable": false, "type": "CURRENT", "account_id": "550e8400-e29b-41d4-a716-446655440000", "available_balance": 1000000, "balance": { "total_balance": 1500000, "hold_amount": -500000, "available_balance": 1000000 }, "currency": "KES", "status": "ACTIVE", "limits": { "minimum_transfer_amount": 1000, "maximum_transfer_amount": 10000000, "daily_transfer_limit": 50000000 }, "interest": { "deposit": { "annual_rate_basis_points": 300, "payout_frequency": "WEEKLY" } }, "created_at": "2025-09-01T10:15:30Z", "updated_at": "2025-10-15T14:22:00Z"}Get the caller's current-account summary GET
Aggregate figures for the caller's current account — for now, the interest credited to it. The figures are derived from the transaction ledger, which keeps roughly 12 months of history, so credits older than that are not counted.
Upgrade the caller's wallet account to a full current account POST
Submits the caller's KRA PIN, selfie and ID photos to the wallet provider to raise the account from its capped entry tier to the full current-account tier. The upgrade completes asynchronously via a provider callback; on success the account's limits are raised. Returns 409 if the caller has no active, upgradeable current account.