Directors

Directors represent the officers and shareholders of a limited company. Each director record holds personal details, appointment dates, shareholding information, and optional connected person relationships for S455 aggregation.

A person is a director by virtue of being in the directors table. The isShareholder flag additionally controls whether they participate in dividend allocation. Share class and shares held are used in dividend per-share calculations.

Connected Persons

Directors can be linked via connectedToDirectorId and relationship (spouse, child, parent, associate). These links are used by the Director Loan Account balance endpoints to aggregate connected persons' DLA balances for S455 Corporation Tax exposure calculation, per HMRC connected persons rules. Both fields must be provided together or both omitted.

Soft Deletion

Directors are soft-deleted via the resign endpoint (DELETE), which sets resignedDate to the current date (if not already set) and marks them inactive. No request body is accepted — the resignation date is always the current date. Resigned directors remain in the system for historical reporting on dividends and director loan accounts.

Requires limited company plan. All queries are RLS-scoped.

→ The Directors object

Endpoints

GET https://app.speybooks.com/api/v1/directors/ List directors and shareholders POST https://app.speybooks.com/api/v1/directors/ Add a director or shareholder GET https://app.speybooks.com/api/v1/directors/{id} Get director details PATCH https://app.speybooks.com/api/v1/directors/{id} Update director details DELETE https://app.speybooks.com/api/v1/directors/{id} Resign a director