The Directors object

A director or shareholder of the limited company. Identity fields are complemented by shareholding details, appointment and resignation dates, and an optional connected-person link for S455 aggregation.

Attributes

idstring

Prefixed director ID (for example dir_1). Stable for the life of the record.

userIdstring

Prefixed user ID when the director has a linked platform account, otherwise null (for example a spouse who holds shares but does not log in).

fullNamestring

Full legal name of the director or shareholder.

emailstring

Email address, or null.

addressstring

Postal address, or null.

isShareholderstring

Whether this person is a shareholder. A dividend can only be declared to a shareholder.

sharesHeldstring

Number of shares held, or null. Feeds per-share dividend arithmetic.

shareClassstring

Share class held (for example Ordinary). Defaults to Ordinary.

appointedDatestring

Date of appointment (YYYY-MM-DD), or null.

resignedDatestring

Date of resignation (YYYY-MM-DD), or null while active. Once stamped it is preserved.

activestring

Whether the director is currently active. Set to false on resignation.

connectedToDirectorIdstring

Prefixed director ID of the person this director is connected to for S455, or null. Set together with relationship.

relationshipstring

Relationship to the connected director, one of spouse, child, parent, or associate, or null. Set together with connectedToDirectorId.

createdAtstring

Creation timestamp, ISO 8601.

updatedAtstring

Last-updated timestamp, ISO 8601.

The Directors Objectjson

{
  "id": "dir_1",
  "userId": "usr_1",
  "fullName": "Fiona Grant",
  "email": "director@example.com",
  "address": null,
  "isShareholder": true,
  "sharesHeld": 100,
  "shareClass": "Ordinary",
  "appointedDate": "2024-01-15",
  "resignedDate": null,
  "active": true,
  "connectedToDirectorId": null,
  "relationship": null,
  "createdAt": "2024-01-15T09:00:00Z",
  "updatedAt": "2024-01-15T09:00:00Z"
}