Skip to main content
The Shares Report shows how the total savings pool is distributed across your membership. For each member it displays their current savings balance and the percentage of total savings that balance represents — their “share” of the group’s equity. Because dividends in most tontines are allocated in proportion to member contributions, the shares report is the definitive reference before any profit distribution. It is also the most transparent way to show members their standing in the group at an Annual General Meeting or quarterly review.
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

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

Response Structure

{
  "asOfDate": "2026-06-30T00:00:00.000Z",
  "totalShares": 10000000.00,
  "rows": [
    {
      "organizationUserId": "orguser-123",
      "name": "John Doe",
      "accountNumber": "SAV-001",
      "amount": 1200000.00,
      "percentage": 12.00
    },
    {
      "organizationUserId": "orguser-456",
      "name": "Jane Smith",
      "accountNumber": "SAV-002",
      "amount": 1000000.00,
      "percentage": 10.00
    },
    {
      "organizationUserId": "orguser-789",
      "name": "Peter Kalisa",
      "accountNumber": "SAV-003",
      "amount": 800000.00,
      "percentage": 8.00
    }
  ]
}
Response fields
FieldTypeDescription
asOfDateISO datetimeThe snapshot date used for the report
totalSharesnumberSum of all member savings balances with positive values
rowsarrayMember share records, sorted by amount descending (largest first)
rows[].organizationUserIdstringMember’s organization user ID
rows[].namestringMember’s full name
rows[].accountNumberstringSavings ledger account number
rows[].amountnumberMember’s savings balance as of asOfDate
rows[].percentagenumberamount ÷ 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.
Share Percentage = (Member's Savings Balance ÷ Total Group Savings) × 100

Example:
  Total group savings: 10,000,000 RWF
  Jane's savings:         500,000 RWF
  Jane's share:               5.00%
This percentage directly determines:
  • 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
A member’s percentage can change even if their own balance stays the same — because other members are also depositing. If the total pool grows faster than an individual member’s balance, their percentage falls. Explain this dynamic to members before publishing the report to avoid confusion.

Four Use Cases

Before running a dividend distribution, generate the shares report to preview each member’s exact allocation.
GET /reports/shares-report?asOfDate=2026-06-30
Calculation example — distributing 500,000 RWF profit proportionally:
MemberShare %Dividend (500,000 RWF)
John Doe12.00%60,000 RWF
Jane Smith10.00%50,000 RWF
Peter Kalisa8.00%40,000 RWF
Verify these figures against member records before posting dividend transactions.
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
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”)
This level of transparency builds trust and reduces disputes about profit allocation.
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
A member’s balance decreases when:
  • They make a withdrawal (subject to group rules)
  • Fees are deducted from their savings account
A member’s percentage changes when:
  • Their own balance changes, or
  • The total group savings changes because other members deposit or withdraw
Illustrative example:
Month 1:
  Jane's balance:   500,000 RWF
  Total savings: 10,000,000 RWF
  Jane's share:        5.00%

Month 2 (Jane deposits 100,000 RWF; others deposit 2,000,000 RWF collectively):
  Jane's balance:   600,000 RWF
  Total savings: 12,100,000 RWF
  Jane's new share:    4.96%  ← lower despite a higher balance
Jane’s absolute savings grew, but her percentage fell because the total pool grew faster. This is normal and expected — it is not an error.

Key Metrics

Calculate these figures from the report data to present in board or AGM materials: Average share per member:
Average = totalShares ÷ number of rows
Ownership concentration (top 10%):
Concentration = Sum of balances for top 10% of members ÷ totalShares × 100
A healthy organization typically shows 20–40% concentration in the top 10% of members. Significantly higher concentration warrants a governance review. Member participation rate:
Participation Rate = Active members in report ÷ Total registered members × 100
Aim for above 80% of registered members actively saving.

Reconciliation with the Balance Sheet

The totalShares 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.
Balance Sheet — Liabilities (as of June 30, 2026):
  Organization User Savings:  10,000,000 RWF

Shares Report (asOfDate = June 30, 2026):
  totalShares:                10,000,000 RWF  ✓ Must match
If the figures differ, check for recently posted transactions that may not yet be reflected, or look for savings accounts that were missed in one report’s query.

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