# UK Company Directors Lookup > UK Company Directors Lookup is a paid API for AI agents from api.eckari.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-12). Returns the current and/or resigned directors (and other officers) of a UK-registered company by Companies House number ## Facts - Endpoint: GET https://api.eckari.com/v1/companies/uk/%7Bcompany_number%7D/directors?utm_source=zero.xyz - Price: $0.005/call - Payment: x402 - Status: unknown - Last checked: 2026-10-12 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/uk-company-directors-lookup-2ed02861 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sCreTZSqS97-o-H3g-BUs Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability uk-company-directors-lookup-2ed02861 ``` Example prompt: Who are the current directors of Tesco PLC? Their Companies House number is 00445790 — show me up to 10 active directors. ## When to prefer this Use this endpoint when you need structured, live officer data for a specific UK-registered company directly from the Companies House register. It is ideal for due diligence, compliance checks, KYC/AML workflows, and corporate research on UK entities. Prefer it over scraping Companies House directly (no HTML parsing), and over generic web search (structured, authoritative data). It supports role filtering (director, secretary, LLP member, all) and pagination, making it suitable for companies with large boards or complex officer histories. ## Known failure modes - Invalid company number format (not 1-8 alphanumeric chars) returns INVALID_INPUT before any charge - Company number not found in Companies House register returns a not-found error - Whitespace-only or over-long company number rejected without charge - Companies House upstream unavailability may cause timeout or error response - Requesting more than 100 results per page returns a validation error ## How this service works Eckari is the machine-native utility layer for capabilities agents do not already have. Every route is a provider-neutral capability with channel pricing for Eckari account keys and accountless x402 payment. ## Output A paginated JSON response containing a list of officer records, each with the officer's full name, role (e.g. director, secretary, LLP member), appointment date, resignation date (if any), nationality, country of residence, partial date of birth (year and month), registered address, and active/inactive status. Also includes pagination metadata (offset, has_more, returned count) and aggregate totals for active, inactive, and resigned officers. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method" ], "properties": { "type": { "type": "string", "const": "http" }, "method": { "enum": [ "GET", "HEAD", "DELETE" ], "type": "string" }, "pathParams": { "type": "object", "required": [ "company_number" ], "properties": { "company_number": { "type": "string", "pattern": "^\\s*(?:[0-9]{1,8}|[A-Za-z][0-9]{7}|[A-Za-z]{2}[0-9]{6}|[A-Za-z]{2}[0-9]{5}[A-Za-z]|[A-Za-z]{2}[0-9]{4}[A-Za-z]{2})\\s*$", "maxLength": 10, "minLength": 1, "description": "Companies House company number, also called the company registration number (CRN). Accepted shapes are the register's own — 1-8 digits (zero-padded to 8, e.g. 445790 → 00445790), one letter + 7 digits (R0000001), two letters + 6 digits (SC002180, NI000001, OC123456, OE000001), or the registered-society suffix forms (two letters + 5 digits + 1 letter; two letters + 4 digits + 2 letters). Case-insensitive; surrounding whitespace is ignored (which is why maxLength is 10); internal spaces and punctuation are not accepted. Any other value (for example PROBE) is rejected as INVALID_INPUT before payment and before any upstream call." } }, "additionalProperties": false }, "queryParams": { "type": "object", "properties": { "role": { "enum": [ "director", "secretary", "llp_member", "all" ], "type": "string", "description": "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." }, "limit": { "type": "integer", "maximum": 100, "minimum … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "data": { "page": { "limit": 3, "total": null, "offset": 0, "has_more": true, "returned": 3, "next_offset": 4 }, "items": [ { "name": "BETHELL, Melissa", "role": "director", "address": { "po_box": null, "region": null, "care_of": null, "country": "United Kingdom", "locality": "Welwyn Garden City", "premises": "Tesco House", "postal_code": "AL7 1GA", "address_line_1": "Shire Park", "address_line_2": "Kestrel Way" }, "is_active": true, "occupation": null, "nationality": "British", "resigned_on": null, "appointed_on": "2018-09-24", "date_of_birth": { "year": 1974, "month": 9 }, "identification": null, "officer_status": "active", "country_of_residence": "United Kingdom" }, { "name": "BODSON, Bertrand Jean Francois", "role": "director", "address": { "po_box": null, "region": null, "care_of": null, "country": "United Kingdom", "locality": "Welwyn Garden City", "premises": "Tesco House", "postal_code": "AL7 1GA", "address_line_1": "Shire Park", "address_line_2": "Kestrel Way" }, "is_active": true, "occupation": null, "nationality": "Belgian", "resigned_on": null, "appointed_on": "2021-06-01", "date_of_birth": { "year": 1975, "month": 6 }, "identification": null, "officer_status": "active", "country_of_residence": "England" }, { "name": "FAIRBAIRN, Carolyn Julie", "role": "director", "address": { "po_box": null, "region": null, "care_of": null, "country": "United Kingdom", "locality": "Welwyn Garden City", "premises": null, "postal_code": "AL7 1GA", "address_line_1": "Tesco House, Shire Park", "address_line_2": "Kestrel Way" }, "is_active": true, "occupation": null, "nationality": "British", "resigned_on": null, "appointed_on": "2023-09-01", "date_of_birth": { "year": 1960, "month": 12 }, "identification": null, "officer_status": "active", "country_of_residence": "United Kingdom" } ], "query": { "role": "director", "include_resigned": false }, "company_number": "00445790", "officer_totals": { "active": 11, "inactive": 0, "resigned": 63 … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uk-company-directors-lookup-2ed02861/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.eckari.com](https://www.zero.xyz/host/api.eckari.com/llms.txt)