Dividend summary by financial year

GET https://app.speybooks.com/api/v1/dividends/summary

Returns a dividend summary grouped by financial year, showing total declared and paid amounts per director.

Query parameters

financialYearEnd string optional

Financial year end date (YYYY-MM-DD). If omitted, returns all-time summary.

200 Per-director dividend summary with aggregated totals.

Show response fields

financialYear string

totalDeclaredPence integer

totalPaidPence integer

Request GET /v1/dividends/summary curl

curl https://api.speybooks.com/v1/dividends/summary?financialYear=2025-2026 \
  -H "Authorization: Bearer sk_test_..."

Response 200

{
  "success": true,
  "data": {
    "financialYear": "2025-2026",
    "totalDeclaredPence": 4000000,
    "totalPaidPence": 2000000
  }
}