List dividends

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

Returns a paginated list of dividends, optionally filtered by director or financial year. Default pagination: page 1, 50 per page (max 100). Ordered by declaration date descending.

Query parameters

directorId string optional
Filter by director ID (e.g. dir_1).
financialYear string optional
Filter by financial year end date (YYYY-MM-DD).
page integer optional Default: 1
Page number. Default 1.
min: 1
perPage integer optional Default: 50
Results per page. Default 50, maximum 100.
min: 1 · max: 100

Response

200 Paginated list of dividends with director names.
Show response fields
dividends array<object>
Show child attributes
amountPence integer
id string
status string

Error codes

400 Invalid director ID format.