UK Company Directors
The officers appointed to a UK company, with appointment and resignation dates, nationality and correspondence address. Directors by default; secretaries, LLP members and resigned history on request.
Example answer
Who are the directors of this UK company?
GET /v1/companies/uk/00445790/directors?limit=3
- Version
- 3.1.0
- Transport
- HTTP / MCP
- Coverage
- GB
Use this when
- Identify who is legally responsible for a UK company - the directors on the Companies House officers register.
- Who are the directors of this UK company?
- You need the officers of a UK company - the officers register holds directors, secretaries and LLP members, and role selects which.
- You need the current directors of a UK company by company number.
- List the directors of company 00445790.
- You need to check whether a named person is currently a director of the company.
Don't use this when
- You need beneficial owners / persons with significant control — use company.uk.owners.
- You only need whether the company is active — use company.uk.status.
- You would read officer_status/is_active as a statement about the company — it describes the register entry only; a dissolved company's officers are reported inactive (not resigned), so check company.uk.status for the company itself.
- You need the company profile (type, SIC codes, address) — use company.uk.profile.
- You want to search for a person across all companies (officer search) — not supported.
If the user has asked you to inspect a specific website, page or URL, use your browsing tool instead — this capability only returns the Companies House Public Data API record.
Input
Companies House company number, also called the company registration number (CRN). The identifier itself is 1-8 letters/digits; surrounding whitespace is ignored (which is why maxLength is 10), but the value must not contain internal spaces. Short numeric values are zero-padded to 8 characters. A whitespace-only or over-long value is rejected as INVALID_INPUT before any payment or upstream call.
Which appointments to return. Default `director` — the capability's name is its contract. The register encodes the office in officer_role, so the filter is a substring test on it: `director` matches director, corporate-director, nominee-director and corporate-nominee-director; `secretary` matches secretary, corporate-secretary, nominee-secretary and corporate-nominee-secretary; `llp_member` matches llp-member, llp-designated-member and their corporate- forms; `all` returns every appointment the register lists, including managing officers, general partners, judicial factors and the EEIG/SE organ roles. Filtering is applied after the register read, so read page.has_more rather than items.length.
Include resigned officers. Default false.
Maximum officers to return per page (1-100). Default 5. Eckari reads up to three register pages of 100 entries to fill this after the role and resigned filters are applied; if the limit is still unmet, page.has_more is true and page.next_offset says where to resume.
Zero-based index into the register's own officer list (not into the filtered result). Pass back page.next_offset from the previous response to page.
What the result means
Normalised 8-character company number.
The resolved filters, echoed because page.total depends on them.
The register's three officer buckets, register-wide and unaffected by the role filter, the resigned filter or paging. They sum to the register's total number of officer entries for the company. The register publishes no per-role count, which is why page.total is null whenever a role filter is in force.
Officer entries in the register's own order, filtered by role (default director). Resigned entries are omitted unless include_resigned is true; inactive entries (a dissolved company's officers) are always returned, because the register does not treat them as resigned.
Provenance
- Source
- Companies House
- Freshness
- Live · read at request time, not cached
- Region
- GB
- Attribution
- Contains public sector information licensed under the Open Government Licence v3.0 (Companies House).
Access
- Over MCP
- company_uk_directors
- Over HTTP
- GET https://api.eckari.com/v1/companies/uk/{company_number}/directors
- Price
- $0.005 per call over x402. Account access $0.004 when that rail opens.
Related capabilities
The persons with significant control of a UK company, each nature of control carrying its official register text. An empty result is not necessarily "no owner" — ownership_status explains why.
The standard registered record for a UK company: name, status, type, jurisdiction, incorporation date, SIC codes with their official descriptions and registered office.
Whether a UK company is active, dissolved, in liquidation or subject to a proposal to strike off, with the register's status detail and cessation date.
A UK company's filings, most recent first — accounts, confirmation statements, appointments, resolutions and charges — each with form type and a link to the filed document.