Record board minutes approving a dividend declaration
POST
https://app.speybooks.com/api/v1/dividends/board-minutesRecords the board resolution that approves a dividend distribution and opens its allocation. The attendees are the directors present and must be active directors. The approved total must be positive and cannot exceed the retained profit available for the financial year, checked against cumulative retained earnings net of what earlier resolutions have already approved; an insufficient figure is refused. On success the resolution opens in the approved state with its full approved total available to declare, and the creation is recorded in the audit trail.
Body parameters
attendeesarray<string>optionalDirector IDs who attended the meeting (e.g. ["dir_1", "dir_2"]). At least one required.
datestringoptionalDate the board meeting was held (YYYY-MM-DD).
financialYearEndstringoptionalFinancial year end date the dividend relates to (YYYY-MM-DD).
notesstringoptionalOptional meeting notes (max 5000 characters).
retainedProfitPenceintegeroptionalRetained profit figure in pence used for the profit sufficiency check.
totalDividendPenceintegeroptionalTotal dividend amount approved in pence. Cannot exceed retainedProfitPence.
Response
201Board minutes recorded. Returns the board minutes object with remaining allocation.
Show response fields
idstringremainingPenceintegerstatusstringtotalDividendPenceintegerError codes
400Validation error, invalid director IDs, or insufficient retained profits.