Mark a dividend as paid

PATCHhttps://app.speybooks.com/api/v1/dividends/{id}/pay

Marks a declared dividend as paid and posts the payment journal, debiting the dividend liability and crediting the bank or the director's loan account according to the payment method. The payment date defaults to the server date when not supplied. A dividend that is already paid or voided cannot be paid again.

Path parameters

idstringrequired
Dividend ID (e.g. div_1). Must use the dividend prefix.

Body parameters

paidDatestringoptional
Payment date (YYYY-MM-DD). Defaults to today if omitted.
pattern: ^\d{4}-\d{2}-\d{2}$

Response

200Dividend marked as paid. Returns the updated dividend with payment journal details.
Show response fields
amountPenceinteger
idstring
paidDatestring
statusstring

Error codes

400Dividend is already paid or voided.
404Dividend not found.
409No accounting period set for this limited company.