Dividend summary by financial year

GEThttps://app.speybooks.com/api/v1/dividends/summary

Summarises dividends per shareholder for a financial year, with declared, paid, and unpaid totals, alongside organisation totals. Voided dividends are excluded from the declared and paid figures. Omitting the financial year end returns an all-time summary.

Query parameters

financialYearEndstringoptional

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

Response

200Per-director dividend summary with aggregated totals.

Show response fields

directorsarray<object>

Show child attributes

directorIdstring

dividendCountinteger

fullNamestring

shareClassstring

sharesHeldinteger

totalDeclaredPenceinteger

totalPaidPenceinteger

totalUnpaidPenceinteger

financialYearEndstring

totalDeclaredPenceinteger

totalPaidPenceinteger

totalUnpaidPenceinteger

RequestGET/v1/dividends/summarycurl

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

Response200

{
  "success": true,
  "data": {
    "financialYearEnd": "2026-03-31",
    "directors": [
      {
        "directorId": "dir_1",
        "fullName": "Fiona Grant",
        "sharesHeld": 60,
        "shareClass": "Ordinary",
        "totalDeclaredPence": 800000,
        "totalPaidPence": 0,
        "totalUnpaidPence": 800000,
        "dividendCount": 1
      }
    ],
    "totalDeclaredPence": 800000,
    "totalPaidPence": 0,
    "totalUnpaidPence": 800000
  }
}