Skip to main content

Changelog

All notable changes to the Kora CBA API.

v1.4.0 — 2026-02-01​

Added​

  • Cross-currency transfers — Transfer between accounts in different currencies with automatic exchange rate conversion (POST /api/v1/transfers/cross-currency).
  • Comparative financial reports — Side-by-side P&L and balance sheet comparison across fiscal periods.
  • Statement of changes in equity — New report endpoint (GET /api/v1/reports/changes-in-equity).

Changed​

  • Exchange rates now support buy, sell, and mid rate types.

v1.3.0 — 2025-12-10​

Added​

  • Virtual accounts — Create collection, sweep, sub-account, escrow, and pooling accounts under a parent (POST /api/v1/accounts/:id/virtual-accounts).
  • Auto-sweep configuration — Configure automatic balance sweeps between virtual and parent accounts.
  • Consolidated balance — Aggregate balance across parent and virtual accounts (GET /api/v1/accounts/:id/consolidated-balance).

Changed​

  • Account search now uses cursor-based pagination (breaking change from offset-based).

v1.2.0 — 2025-10-15​

Added​

  • Standing instructions — Recurring journal entries with configurable frequency (daily, weekly, monthly, quarterly, annually).
  • Batch journal operations — Create and post multiple journals in a single request.
  • Inter-branch transfers — GL-level transfers between branch accounts.

Fixed​

  • Year-end close now correctly handles period 13 (adjustment period).

v1.1.0 — 2025-08-20​

Added​

  • Financial reporting — Trial balance, P&L, balance sheet, and cash flow reports.
  • Consolidated reports — Cross-branch consolidated trial balance and P&L.
  • Fiscal period management — Auto-generate yearly periods, period close, year-end close.
  • Account holds — Place and release holds on account balances with expiry.

Changed​

  • Journal posting now creates daily balance snapshots for all affected accounts.

v1.0.0 — 2025-06-01​

Initial Release​

  • Microservices architecture with API gateway, GL service, account service, and transaction service.
  • Double-entry general ledger with hierarchical chart of accounts.
  • Account management (savings, current, fixed deposit, domiciliary, joint, corporate).
  • Internal and interbank (NIBSS NIP) transfers with fee calculation.
  • JWT authentication with RSA-256 signing and RBAC (viewer, teller, officer, manager, admin).
  • Database-per-tenant multi-tenancy with PostgreSQL RLS.
  • Idempotency support for all write operations.
  • Webhook event system with HMAC-SHA256 signature verification.
  • Distributed rate limiting via Redis.