{"slug":"api-staging-eckari-com-v1-companies-uk-company-number-direct-a7a0a7","title":"Directors of a UK company from the Companies House officers register — the regis","host":"api-staging.eckari.com","method":"GET","resource":"https://api-staging.eckari.com/v1/companies/uk/:company_number/directors","category":"company","description":"Directors of a UK company from the Companies House officers register — the register of directors, secretaries and LLP members — including corporate and nominee directors, with appointment and resignation dates, nationality, country of residence, occupation, month/year of birth and correspondence add","price_listed":0.005,"price_asked":0.005,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":1161,"reported_calls_30d":5,"reported_payers_30d":1,"networks":["eip155:84532"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","pathParams":{"company_number":"00445790"},"queryParams":{"limit":3},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"pathParams":{"additionalProperties":false,"properties":{"company_number":{"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.","maxLength":10,"minLength":1,"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*$","type":"string"}},"required":["company_number"],"type":"object"},"queryParams":{"additionalProperties":false,"properties":{"include_resigned":{"description":"Include resigned officers. Default false.","type":"boolean"},"limit":{"description":"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.","maximum":100,"minimum":1,"type":"integer"},"offset":{"description":"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.","maximum":10000,"minimum":0,"type":"integer"},"role":{"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.","enum":["director","secretary","llp_member","all"],"type":"string"}},"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.005,"price_match":true,"latency_ms":1161,"error":null}],"description_full":"Directors of a UK company from the Companies House officers register — the register of directors, secretaries and LLP members — including corporate and nominee directors, with appointment and resignation dates, nationality, country of residence, occupation, month/year of birth and correspondence address. role and include_resigned widen it. Use when: Identify who is legally responsible for a UK company - the directors on the Companies House officers register.","last_updated":"2026-08-27T22:23:56.342Z","schemes":["exact"]}