Declare a dividend for a director

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

Declares a dividend for a specific director, linked to approved board minutes. Creates the double-entry journal: debit Dividends Paid (P&L), credit Dividends Payable (liability).

The dividend must not exceed the total approved in the board minutes. A unique voucher number is auto-generated.

Body parameters

amountPence integer optional
Gross dividend amount in pence. Cannot exceed the remaining allocation on the board minutes.
boardMinutesId string optional
Board minutes ID authorising this dividend (e.g. bmin_1). Must be in approved status.
createJournal boolean optional
Whether to create double-entry journal entries. Defaults to true.
date string optional
Dividend declaration date (YYYY-MM-DD).
date
directorId string optional
Director/shareholder ID receiving the dividend (e.g. dir_1). Must be an active shareholder.
notes string optional
Optional notes (max 2000 characters).
paymentMethod string optional
How the dividend will be paid. dla_offset automatically creates DLA journal entries and marks as paid.
bank_transferdla_offsetcheque
shareClass string optional
Share class for this dividend. Defaults to Ordinary.

Response

201 Dividend declared. Returns the dividend object with voucher number and journal transaction ID.
Show response fields
id string
voucherNumber string

Error codes

400 Validation error, insufficient allocation, or director is not a shareholder.
404 Board minutes or director not found.