{"uid":"cap_sCreTZSqS97-o-H3g-BUs","slug":"uk-company-directors-lookup-2ed02861","name":"UK Company Directors Lookup","description":"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.","url":"https://api.eckari.com/v1/companies/uk/%7Bcompany_number%7D/directors?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":1,"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."},"offset":{"type":"integer","maximum":10000,"minimum":0,"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."},"include_resigned":{"type":"boolean","description":"Include resigned officers. Default false."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"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}},"meta":{"source":"companies_house","version":"3.1.0","freshness":"live","capability":"company.uk.directors"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rGRpGFXRfJ_pueKdz3-z0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current and/or resigned directors (and other officers) of a UK-registered company by Companies House number","exampleAgentPrompt":"Who are the current directors of Tesco PLC? Their Companies House number is 00445790 — show me up to 10 active directors.","exampleUseCases":[{"title":"Due diligence on a UK supplier","prompt":"I need to verify who's running Rolls-Royce Holdings — can you pull their current directors from Companies House? Their company number is 01003142."},{"title":"Checking for nominee directors","prompt":"Can you list all officers for company number 12345678, including secretaries and any nominee directors? I want to see everyone on the register, not just the main directors."},{"title":"Investigating resigned board members","prompt":"I'm researching the board history of a UK company — number 00102498. Can you show me who resigned as directors in the last few years? Use the 'all' role filter so I don't miss anyone."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:30:33.502Z","isFirstParty":false,"canonicalSlug":"uk-company-directors-lookup-2ed02861"}