{"uid":"cap_LIEPeDdGUHaedLH5jp6tW","slug":"celer-api-uk-companies-house-search-0a80d30c","name":"Celer API UK Companies House Search","description":"Search authoritative company registries by company name to resolve candidate legal entities and registration identifiers. Currently supports the United Kingdom (GB) and Norway (NO), with expanding jurisdiction coverage. Results are public-register evidence, not a KYC or KYB compliance determination.","url":"https://www.celerapi.com/v1/company/search","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"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":200,"minLength":1,"description":"Company or business name to search in the selected authoritative company registry."},"country":{"enum":["GB","NO"],"type":"string","default":"GB","description":"ISO alpha-2 country hint; omission defaults to GB."},"jurisdiction":{"type":"string","pattern":"^[A-Za-z0-9-]{2,32}$","description":"Optional sub-jurisdiction hint."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["success","complete","entity_ids","data","provenance","warnings"],"properties":{"data":{"type":"array","items":{"type":"object","required":["entity_id","legal_name","company_number","registration_number","country","jurisdiction","source","available_capabilities"],"properties":{"source":{"type":"object","required":["authority","provider"],"properties":{"provider":{"type":"string"},"authority":{"type":"string"}}},"status":{"type":"string"},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"entity_id":{"type":"string","example":"gb:companies-house:09446231"},"legal_name":{"type":"string"},"match_type":{"enum":["exact","prefix","fuzzy","provider_ranked","unknown"]},"entity_type":{"type":"string"},"company_type":{"type":"string"},"jurisdiction":{"type":"string"},"company_number":{"type":"string"},"company_status":{"type":"string"},"dissolution_date":{"type":"string","format":"date"},"local_identifiers":{"type":"object","additionalProperties":{"type":"string"}},"incorporation_date":{"type":"string","format":"date"},"registered_address":{"type":"object","properties":{"po_box":{"type":"string"},"region":{"type":"string"},"care_of":{"type":"string"},"country":{"type":"string"},"locality":{"type":"string"},"premises":{"type":"string"},"postal_code":{"type":"string"},"address_line_1":{"type":"string"},"address_line_2":{"type":"string"}},"additionalProperties":false},"registration_number":{"type":"string"},"available_capabilities":{"type":"array","items":{"enum":["profile","officers","owners","filings","insolvency"]},"uniqueItems":true},"registered_office_address":{"type":"object","properties":{"po_box":{"type":"string"},"region":{"type":"string"},"care_of":{"type":"string"},"country":{"type":"string"},"locality":{"type":"string"},"premises":{"type":"string"},"postal_code":{"type":"string"},"address_line_1":{"type":"string"},"address_line_2":{"type":"string"}},"additionalProperties":false}}}},"success":{"const":true},"complete":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}},"entity_ids":{"type":"array","items":{"type":"string"}},"provenance":{"type":"object","required":["source","jurisdiction","registry","retrieved_at","freshness"],"properties":{"source":{"type":"string"},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"provider":{"type":"string"},"registry":{"type":"string"},"authority":{"type":"string"},"freshness":{"const":"live"},"jurisdiction":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"}}}}}}}}},"responseSchema":{"type":"json","example":{"data":[{"source":{"provider":"companies_house","authority":"UK Companies House"},"country":"GB","entity_id":"gb:companies-house:09446231","legal_name":"MONZO BANK LIMITED","jurisdiction":"GB","company_number":"09446231","registration_number":"09446231","available_capabilities":["profile","officers","owners","filings","insolvency"]}],"success":true,"complete":true,"warnings":[],"entity_ids":["gb:companies-house:09446231"],"provenance":{"source":"UK Companies House","registry":"companies_house","freshness":"live","jurisdiction":"GB","retrieved_at":"2026-08-26T00:00:00.000Z"}}},"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_hjm8nCZjtyyehD1Vk04K0","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":"Search UK Companies House registry by company name and retrieve company records","exampleAgentPrompt":"Can you search UK Companies House for 'Acme Technologies Ltd' and tell me what comes up?","exampleUseCases":[{"title":"Verify a UK supplier's registration","prompt":"I need to check if 'Meridian Supply Chain Ltd' is actually a registered UK company — can you search Companies House for it and tell me what you find?"},{"title":"Find company number for contract","prompt":"I'm drafting a contract and need the official Companies House registration details for 'Blue Horizon Consulting Ltd' — can you look it up?"},{"title":"Due diligence on a potential partner","prompt":"We're considering partnering with a firm called 'Apex Digital Solutions' in the UK — can you search Companies House to see if they're registered and pull up their company info?"}],"resultDescription":"Returns a structured response including success status, completeness flag, an array of matching company records from UK Companies House, entity ID, provenance metadata describing the data source, and any warnings. The data field contains the actual company search results.","failureModes":["Empty query string returns validation error","No matching companies found returns empty data array","Companies House API unavailability may cause incomplete results indicated by complete:false flag","Query too long (over 200 characters) rejected by schema validation","Network timeout or upstream provider error"],"whenToPreferThis":"Use this endpoint when you need to search the UK Companies House registry by company name. It is ideal for agent workflows requiring UK company verification, due diligence, contract preparation, or business identity confirmation. Prefer this over generic web search when you need structured, authoritative company registration data from the official UK government registry.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:49:25.195Z","isFirstParty":false}