The
reports:read permission is required. Only members with a positive savings balance appear in the report — members with a zero or negative balance are excluded. All figures are drawn from posted journal entries up to and including the asOfDate.API Endpoint
| Parameter | Type | Required | Description |
|---|---|---|---|
asOfDate | ISO date | No | Snapshot date. Defaults to today if omitted. |
Response Structure
| Field | Type | Description |
|---|---|---|
asOfDate | ISO datetime | The snapshot date used for the report |
totalShares | number | Sum of all member savings balances with positive values |
rows | array | Member share records, sorted by amount descending (largest first) |
rows[].organizationUserId | string | Member’s organization user ID |
rows[].name | string | Member’s full name |
rows[].accountNumber | string | Savings ledger account number |
rows[].amount | number | Member’s savings balance as of asOfDate |
rows[].percentage | number | amount ÷ totalShares × 100, rounded to 2 decimal places |
What Is a Share?
In Agatabo’s tontine model, a share is simply a member’s current savings balance. There are no certificates or fixed units — ownership is fluid and updates automatically with every deposit and withdrawal.- Dividend allocation when profits are distributed by contribution
- Ownership stake in the group’s net equity
- Proportional claim on group assets if the group were ever dissolved
Four Use Cases
Dividend Distribution Planning
Dividend Distribution Planning
Before running a dividend distribution, generate the shares report to preview each member’s exact allocation.Calculation example — distributing 500,000 RWF profit proportionally:
Verify these figures against member records before posting dividend transactions.
| Member | Share % | Dividend (500,000 RWF) |
|---|---|---|
| John Doe | 12.00% | 60,000 RWF |
| Jane Smith | 10.00% | 50,000 RWF |
| Peter Kalisa | 8.00% | 40,000 RWF |
| … | … | … |
Member Equity Tracking
Member Equity Tracking
Run the report at the end of each quarter and compare it to the previous quarter to show members how their ownership stake is evolving.What to look for:
- Members whose balance and percentage are both growing — actively contributing
- Members whose balance is flat but percentage is declining — being diluted by others’ deposits
- Members who have dropped out of the report entirely — withdrew all savings or became inactive
Transparency at General Meetings
Transparency at General Meetings
Print or project the shares report at your Annual General Meeting so every member can see:
- Their exact savings balance (“You have 500,000 RWF in savings”)
- Their ownership percentage (“That is 5.00% of the total pool”)
- The basis for their dividend (“If we distribute 1,000,000 RWF, you receive 50,000 RWF”)
Board Reporting on Ownership Concentration
Board Reporting on Ownership Concentration
Use the report to assess whether savings are broadly distributed or concentrated in a few large accounts. High concentration (e.g., top three members holding 50%+ of savings) can indicate governance risk if those members withdraw simultaneously.Key metrics to present:
- Total shares and growth vs prior period
- Number of active members (rows in the report)
- Percentage held by top 10% of members
- Average balance per member
Understanding Share Changes
A member’s balance increases when:- They make a deposit
- Interest is credited to their savings account
- A dividend is reinvested rather than paid out
- They make a withdrawal (subject to group rules)
- Fees are deducted from their savings account
- Their own balance changes, or
- The total group savings changes because other members deposit or withdraw
Key Metrics
Calculate these figures from the report data to present in board or AGM materials: Average share per member:Reconciliation with the Balance Sheet
ThetotalShares in this report must equal the Organization User Savings liability line on the Balance Sheet when both reports are run as of the same date.
Related Reports
Balance Sheet
Total shares equals the Member Savings liability line
Profit & Loss
Net profit is the pool available for dividend distribution
Loans Outstanding
Member savings fund the loan portfolio shown here
Report Export
Bundle the shares report with other reports for member meetings