Skip to main content
Agatabo’s reporting suite gives administrators, treasurers, and accountants a complete view of your savings group’s financial health — all generated on demand from posted general ledger entries. Every report reflects real-time data, so the numbers you see are always current as of the date you choose. Draft journal entries are never included, which means your reports show only finalized, confirmed transactions.
All reports require the reports:read permission. Users assigned the Administrator, Accountant, Treasurer, or Board Member role typically have this permission by default. Contact your organization administrator if you cannot access the Reports section.

​
Available Reports

Agatabo provides five reports across two categories: financial statements for compliance and governance, and analytical reports for portfolio oversight and member communication.

​
Financial Statements

Balance Sheet

A point-in-time snapshot of assets, liabilities, and equity. Use it for board reports, audits, and regulatory filings.

Profit & Loss

Income minus expenses over a chosen period. Use it to track operational performance and guide profit-allocation decisions.

​
Analytical Reports

Loans Outstanding

Active loan portfolio with outstanding balances, expected payments, and arrears by borrower.

Shares Report

Each member’s savings balance expressed as a percentage of total group savings.

Account Statements

Generate account statements for any ledger account from the General Ledger section.

​
When to Use Each Report

ReportBest Used ForKey Date Parameter
Balance SheetMonth-end board packs, audits, regulatory filingsasOfDate — snapshot date
Profit & LossMonthly performance review, tax filing, dividend planningstartDate / endDate — period
Loans OutstandingPortfolio monitoring, collections, liquidity planningexpectedDate — arrears cutoff
Shares ReportDividend distribution basis, AGM transparency, equity trackingasOfDate — snapshot date
Account StatementsMember communication, bank reconciliation, audit schedulesfrom / to — period

​
API Endpoints

Each report is available via a dedicated REST endpoint. Pass your organization ID in the x-organization-id header on every request.

​
Balance Sheet

GET /reports/balance-sheet?asOfDate={YYYY-MM-DD}
x-organization-id: {organizationId}
ParameterTypeRequiredDescription
asOfDateISO dateNoSnapshot date. Defaults to today.

​
Profit & Loss

GET /reports/profit-loss?startDate={YYYY-MM-DD}&endDate={YYYY-MM-DD}
x-organization-id: {organizationId}
ParameterTypeRequiredDescription
startDateISO dateNoPeriod start. Defaults to organization creation date.
endDateISO dateNoPeriod end. Defaults to today.

​
Loans Outstanding

GET /reports/loans-outstanding?expectedDate={YYYY-MM-DD}
x-organization-id: {organizationId}
ParameterTypeRequiredDescription
expectedDateISO dateNoArrears calculation date. Defaults to today.

​
Shares Report

GET /reports/shares-report?asOfDate={YYYY-MM-DD}
x-organization-id: {organizationId}
ParameterTypeRequiredDescription
asOfDateISO dateNoSnapshot date. Defaults to today.

​
Account Statements

POST /ledger-accounts/statements
x-organization-id: {organizationId}

{
  "accountIds": ["acc-123", "acc-456"],
  "from": "2026-01-01",
  "to": "2026-06-30",
  "option": "period",
  "excludeZeroTransactionAccounts": false
}
FieldTypeRequiredDescription
accountIdsstring[]YesOne or more ledger account UUIDs.
fromISO dateYesStatement start date.
toISO dateYesStatement end date.
optionenumYesall, current, period, or custom.
excludeZeroTransactionAccountsbooleanNoSkip accounts with no activity in period.
Account Statements use a different permission (ledger:read) and a different base endpoint (/ledger-accounts/statements) compared to the other four reports. Generate them from the General Ledger section of the UI rather than the Reports section.

​
Generating a Report

1

Open the Reports section

Click Reports in the left-hand navigation bar. If you cannot see the menu item, your account lacks the reports:read permission — contact your administrator.
2

Choose a report type

Select the report you need: Balance Sheet, Profit & Loss, Loans Outstanding, or Shares Report. For account statements, navigate to General Ledger → Statements instead.
3

Set your date parameters

Enter the relevant dates for the report you chose:
  • Balance Sheet / Shares Report — enter an as-of date (a single end date).
  • Profit & Loss — enter a start date and end date defining the performance period.
  • Loans Outstanding — enter an expected date to control the arrears calculation cutoff.
Leave any field blank to use the default (usually today’s date).
4

Generate and review

Click Generate. Agatabo queries the live ledger and returns your report in seconds. Review the figures on screen before exporting.
Use the Report Export Builder to bundle multiple reports into a single PDF or set of CSV files in one step — ideal for monthly board packs and annual audit packages. See Report Export for details.

​
Required Permissions

Permission: reports:read
Scope:      Organization level
RoleHas reports:read
Administrator✅
Accountant✅
Treasurer✅
Board Member✅ (read-only)
Regular Member❌
Users without reports:read cannot access any /reports endpoint or view financial statements in the UI.

​
Report Data Sources

Every report is derived exclusively from posted journal entries and ledger account balances. The table below shows what each report draws from:
Data SourceUsed By
Ledger account balancesBalance Sheet, Shares Report
Posted journal entries (date range)Profit & Loss, Account Statements
Loan metadata + installment schedulesLoans Outstanding
Member SAVINGS ledger accountsShares Report
Always ensure all transactions for the relevant period are posted before generating a report. Draft journal entries are excluded and will cause totals to appear lower than expected.

​
Explore Each Report

Balance Sheet

Assets, liabilities, and equity at a point in time

Profit & Loss

Income and expenses over a period

Loans Outstanding

Active loan portfolio with arrears detail

Shares Report

Member ownership distribution by savings balance

Report Export

Bundle multiple reports into one download

Account Statements

Generate account statements for any ledger account from the General Ledger section.