List directors and shareholders

GEThttps://app.speybooks.com/api/v1/directors/

Returns the directors and shareholders for the organisation, active ones first and then by name. The list is filtered to active directors by default; pass active=false to return resigned directors, or set shareholdersOnly to return only shareholders.

Query parameters

activebooleanoptionalDefault: true

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

shareholdersOnlybooleanoptionalDefault: false

If true, returns only directors who are shareholders.

Response

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

Show response fields

directorsarray<object>

Show child attributes

activeboolean

connectedToDirectorIdstringnullable

fullNamestring

idstring

isShareholderboolean

relationshipstringnullable

RequestGET/v1/directors/curl

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

Response200

{
  "success": true,
  "data": {
    "directors": [
      {
        "id": "dir_1",
        "fullName": "Fiona Grant",
        "isShareholder": true,
        "active": true,
        "connectedToDirectorId": null,
        "relationship": null
      }
    ]
  }
}