NON-PRODUCTION ENVIRONMENT · STAGING · API https://api-staging.eckari.com
← All capabilities

List UK company directors and officers

company.uk.directorsv1.0.0betaregion GB

Return the officers registered against a UK company (directors, secretaries, LLP members and other officer roles) with role, appointment and resignation dates, nationality, country of residence, occupation, month/year of birth and the public correspondence address. Active officers are returned by default; resigned officers can be included.

Account price
USD 0.004
per successful call · introductory
x402 price
USD 0.005
accountless, settled per call · introductory
Provenance
companies_house
cache: shared · ttl 300s

Endpoint

GET https://api-staging.eckari.com/v1/companies/uk/{companyNumber}/directors
curl -i "https://api-staging.eckari.com/v1/companies/uk/01234567/directors"

Without credentials the gateway responds 402 with a PAYMENT-REQUIRED header (x402 v2). Retry with PAYMENT-SIGNATURE. See docs.

Use when

  • Who are the directors of this UK company?
  • List the current company officers for company 01234567.
  • Who runs this limited company?
  • Has anyone resigned as a director recently?

Do not use when

  • Need beneficial owners / persons with significant control (shareholders, controllers); use company.uk.owners.
  • Only need to know whether the company is active; use company.uk.status.
  • Need the registered profile (type, SIC codes, address); use company.uk.profile.

Synonyms

company directors UKcompany officerswho is the director of a companyboard members Companies Housecompany secretary lookupLLP members

Input schema

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "companyNumber"
  ],
  "properties": {
    "companyNumber": {
      "type": "string",
      "description": "Companies House company number. Whitespace is ignored and short numeric values are zero-padded to 8 characters.",
      "minLength": 1,
      "maxLength": 10,
      "pattern": "^[A-Za-z0-9 ]+$"
    },
    "include_resigned": {
      "type": "boolean",
      "description": "Include resigned officers. Default false."
    },
    "limit": {
      "type": "integer",
      "description": "Maximum officers to return per page (1-100). Default 35.",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "type": "integer",
      "description": "Zero-based offset into the officer list.",
      "minimum": 0,
      "maximum": 10000
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "company_number",
    "total_officers",
    "active_count",
    "resigned_count",
    "offset",
    "officers"
  ],
  "properties": {
    "company_number": {
      "type": "string"
    },
    "total_officers": {
      "type": "integer",
      "description": "Total officers on the register for this company (active + resigned)."
    },
    "active_count": {
      "type": "integer"
    },
    "resigned_count": {
      "type": "integer"
    },
    "offset": {
      "type": "integer"
    },
    "officers": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "name",
          "role",
          "is_active",
          "appointed_on",
          "resigned_on"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Officer name as registered (surname-first for natural persons)."
          },
          "role": {
            "type": "string",
            "description": "Companies House officer_role (e.g. director",
            "secretary": null,
            "llp-member": null,
            "corporate-director).": null
          },
          "is_active": {
            "type": "boolean",
            "description": "Derived; true when no resignation date is recorded."
          },
          "appointed_on": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "resigned_on": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "nationality": {
            "type": [
              "string",
              "null"
            ]
          },
          "country_of_residence": {
            "type": [
              "string",
              "null"
            ]
          },
          "occupation": {
            "type": [
              "string",
              "null"
            ]
          },
          "date_of_birth": {
            "type": [
              "object",
              "null"
            ],
            "description": "Month and year only, as published on the public register.",
            "additionalProperties": false,
            "required": [
              "month",
              "year"
            ],
            "properties": {
              "month": {
                "type": "integer"
              },
              "year": {
                "type": "integer"
              }
            }
          },
          "address": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": false,
            "properties": {
              "care_of": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "premises": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "address_line_1": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "address_line_2": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "po_box": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "locality": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "region": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "postal_code": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "country": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "identification": {
            "type": [
              "object",
              "null"
            ],
            "description": "Corporate officer identification where the officer is a corporate body.",
            "additionalProperties": false,
            "properties": {
              "identification_type": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "legal_authority": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "legal_form": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "place_registered": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "registration_number": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        }
      }
    }
  }
}

Example input · active_directors

{
  "companyNumber": "01234567"
}

Example response

{
  "data": {
    "company_number": "01234567",
    "total_officers": 2,
    "active_count": 1,
    "resigned_count": 1,
    "offset": 0,
    "officers": [
      {
        "name": "DOE, Jane",
        "role": "director",
        "is_active": true,
        "appointed_on": "2015-04-01",
        "resigned_on": null,
        "nationality": "British",
        "country_of_residence": "England",
        "occupation": "Company Director",
        "date_of_birth": {
          "month": 6,
          "year": 1975
        },
        "address": {
          "care_of": null,
          "premises": "1",
          "address_line_1": "Example Street",
          "address_line_2": null,
          "po_box": null,
          "locality": "London",
          "region": null,
          "postal_code": "EC1A 1AA",
          "country": "England"
        },
        "identification": null
      }
    ]
  },
  "meta": {
    "capability": "company.uk.directors",
    "version": "1.0.0",
    "retrieved_at": "2026-08-17T12:00:00Z",
    "source": "companies_house",
    "freshness": "live",
    "request_id": "req_example"
  }
}
JSONOpenAPIMCP tool metadata