List directors and shareholders

GET https://app.speybooks.com/api/v1/directors/

Returns all directors and shareholders for the authenticated organisation, ordered by name. Includes both active and resigned directors by default.

Query parameters

active boolean optional Default: true

Filter by active status. Defaults to true (active directors only).

shareholdersOnly boolean optional Default: false

If true, returns only directors who are shareholders.

Response

200 Returns directors sorted by active status then name. Limited company plan required.

Show response fields

directors array<object>

Show child attributes

active boolean

connectedToDirectorId string nullable

fullName string

id string

relationship string nullable

Request GET /v1/directors/ curl

curl https://api.speybooks.com/v1/directors \
  -H "Authorization: Bearer sk_test_..."

Response 200

{
  "success": true,
  "data": {
    "directors": [
      {
        "id": "dir_1",
        "fullName": "William Murray",
        "active": true,
        "connectedToDirectorId": null,
        "relationship": null
      }
    ]
  }
}