The Directors object

A director or shareholder of the limited company. Core identity fields are complemented by shareholding details, appointment/ resignation dates, and optional connected person links for S455 aggregation.

Attributes

id string
Prefixed director ID (e.g. dir_1). Immutable after creation.
userId string
Prefixed user ID if the director has a linked user account, or null.
fullName string
Full legal name of the director or shareholder.
email string
Optional email address.
address string
Optional postal address, max 2000 characters.
isShareholder string
Whether this person is a shareholder. Controls dividend allocation eligibility.
sharesHeld string
Number of shares held. Used to calculate dividend per share.
shareClass string
Share class held (e.g. Ordinary, A Ordinary). Defaults to Ordinary.
appointedDate string
Date of appointment as director (YYYY-MM-DD), or null.
resignedDate string
Date of resignation, or null if still active.
active string
Whether the director is currently active. Set to false on resignation.
connectedToDirectorId string
Prefixed director ID of the connected person (e.g. dir_1), or null. Used for S455 aggregation.
relationship string
Relationship to the connected director: spouse, child, parent, or associate. Required when connectedToDirectorId is provided.
createdAt string
ISO 8601 creation timestamp.
updatedAt string
ISO 8601 last-updated timestamp.