{"uid":"cap_s5r-hditZlP-VKvijtYsO","slug":"eckari-uk-company-directors-lookup-3ab0a891","name":"Eckari UK Company Directors Lookup","description":"Return the directors of a UK company from the Companies House register — including corporate and nominee directors — with appointment and resignation dates, nationality, country of residence, occupation, month/year of birth and correspondence address. role=secretary, role=llp_member or role=all widen it; include_resigned adds history. Register-wide officer totals and explicit paging come with every answer. Use when: Who are the directors of this UK company?","url":"https://api.eckari.com/v1/companies/uk/:companyNumber/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":null,"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_CoTxlv7p0_DssAQbJpe6k","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":"Retrieve current and historical directors (and optionally secretaries or LLP members) of a UK company from the Companies House register, including appointment dates, nationality, occupation, and address.","exampleAgentPrompt":"Who are the current directors of UK company number 00445790? Include any resigned directors and show me up to 20 results.","exampleUseCases":[{"title":"Due diligence on a UK supplier","prompt":"I need to know who the directors are of UK company 07495895 — please include their nationalities, occupations, and any who have resigned in the past, so I can do a proper background check."},{"title":"Verify a director's appointment status","prompt":"Can you check if someone named James Thornton is currently listed as a director of UK company number 03977902, and when they were appointed?"},{"title":"LLP membership research","prompt":"Pull all the LLP members — including designated members — for UK company OC412345, and include anyone who has left the partnership so I have a full history."}],"resultDescription":"A paginated list of officers matching the role filter, each with full name, officer role, appointment date, optional resignation date, nationality, country of residence, occupation, birth month/year, and correspondence address. The response also includes register-wide officer totals and pagination metadata (has_more, next offset) so the agent can fetch additional pages if needed.","failureModes":["Invalid company number format (not 1-8 alphanumeric characters) returns INVALID_INPUT before any payment","Company number not found in Companies House register returns a not-found error","No officers matching the specified role filter returns an empty items list","Rate limiting or upstream Companies House API unavailability may cause transient errors","Whitespace-only or overly long company number strings are rejected as INVALID_INPUT"],"whenToPreferThis":"Use this endpoint when you need structured, up-to-date director or officer data for a specific UK company registered at Companies House, especially when you need appointment/resignation history, nationality, occupation, or birth month/year. Prefer this over general web search when you need machine-readable, authoritative registry data. Choose role=all when you need secretaries, LLP members, or exotic officer types in addition to directors. Add include_resigned=true when conducting due diligence or building a full governance history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:31:11.166Z","isFirstParty":false,"canonicalSlug":"eckari-uk-company-directors-lookup-3ab0a891"}