{"uid":"cap_ZQX3qjbyVddUIOmnLqVke","slug":"eckari-uk-companies-house-search-3a6d0cae","name":"Eckari UK Companies House Search","description":"Search the UK Companies House register by name or keyword and return matching companies with company number, register status and a derived is_active, type, incorporation and cessation dates and the register's one-line address snippet. Use this first when you only have a name, then call the per-company capabilities with the returned company_number. Ordering is the register's own, echoed as match_rank — a position, not a relevance score. Use when: Look up a UK company by name.","url":"https://api.eckari.com/v1/companies/uk/search?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"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":200,"minLength":2,"description":"Company name or keyword to search for."},"limit":{"type":"integer","maximum":50,"minimum":1,"description":"Maximum results to return (1-50). Default 10."},"offset":{"type":"integer","maximum":10000,"minimum":0,"description":"Zero-based offset into the register's result set for paging. Pass back page.next_offset from the previous response; page.has_more says whether there is one."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"page":{"limit":5,"total":356,"offset":0,"has_more":true,"returned":5,"next_offset":5},"items":[{"type":"plc","status":"active","is_active":true,"match_rank":1,"company_name":"TESCO PLC","company_number":"00445790","address_snippet":"Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA","date_of_creation":"1947-11-27","date_of_cessation":null},{"type":"ltd","status":"active","is_active":true,"match_rank":2,"company_name":"KFORD TYRES (GORNAL) LTD","company_number":"09384423","address_snippet":"2 Dawley Brook Road, Kingswinford, England, DY6 7BD","date_of_creation":"2015-01-12","date_of_cessation":null},{"type":"ltd","status":"dissolved","is_active":false,"match_rank":3,"company_name":"TESCO AQUA (FINCO2) LIMITED","company_number":"05888957","address_snippet":"1 More London Place, London, SE1 2AF","date_of_creation":"2006-07-27","date_of_cessation":"2025-11-12"},{"type":"uk-establishment","status":"closed","is_active":false,"match_rank":4,"company_name":"TESCO AQUA (1LP) LIMITED","company_number":"BR008975","address_snippet":"New Tesco House, Cheshunt, Delamare Road, EN8 9SL","date_of_creation":"2006-08-09","date_of_cessation":null},{"type":"ltd","status":"active","is_active":true,"match_rank":5,"company_name":"TESCO ATRATO DEPOT PROPCO LIMITED","company_number":"06969533","address_snippet":"Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA","date_of_creation":"2009-07-22","date_of_cessation":null}],"query":{"q":"Tesco plc"}},"meta":{"source":"companies_house","version":"2.0.0","freshness":"live","capability":"company.uk.search"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_up3KJ4TpTwGmzB_MeFh9u","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search the UK Companies House register by company name or keyword, returning matching companies with number, status, type, dates and address.","exampleAgentPrompt":"Can you search Companies House for 'Tesco PLC' and give me the company number, status, and registered address?","exampleUseCases":[{"title":"Verify a supplier's company registration","prompt":"I need to verify that 'Acme Logistics Ltd' is a legitimate registered UK company — can you search Companies House for it and tell me the company number, whether it's active, and its registered address?"},{"title":"Find company number before detailed lookup","prompt":"I want to pull the full filing history for a company called 'Greenspark Technologies' but I don't have its company number — can you search Companies House to find it?"},{"title":"Check if a competitor company has dissolved","prompt":"Can you search Companies House for 'BrightPath Media Limited' and tell me whether it's still active or has been dissolved, and if so when?"}],"resultDescription":"Returns a paginated list of matching companies, each with: company_name, company_number, status (e.g. active, dissolved, closed), is_active (boolean), type (e.g. ltd, plc, uk-establishment), date_of_creation, date_of_cessation (null if still active), and address_snippet. Also returns pagination metadata (total results, offset, has_more, next_offset) and echoes the original query. Results are ordered by the register's own match_rank (position, not relevance score).","failureModes":["Query too short (under 2 chars) — returns validation error","No matching companies found — returns empty items array with total=0","offset exceeds 10,000 — returns validation error","Rate limiting or payment failure via x402 — returns 402 Payment Required","Companies House API downstream outage — returns 5xx error","Query returns unexpected company types not handled by caller"],"whenToPreferThis":"Use this endpoint when you have only a company name or keyword and need to resolve it to a Companies House company_number before calling per-company detail endpoints. Prefer this over per-company lookup endpoints when the company number is unknown. Use the returned company_number from this search to chain into profile, filings, or accounts endpoints. Best suited for UK-registered entities; not applicable for companies registered outside the UK.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:47:21.335Z","isFirstParty":false,"canonicalSlug":"eckari-uk-companies-house-search-3a6d0cae"}