{"uid":"cap_PTSHfRroqTO4KJ8KpKLJt","slug":"macaroon-network-companies-house-search-1024de3f","name":"Macaroon Network Companies House Search","description":"Search a bounded snapshot of the UK Companies House register -- company name, number, status, category, registered address, and SIC code. Published under the Open Government Licence v3.0, which explicitly permits commercial reuse.","url":"https://api.macaroonnetwork.com/execute/companies-house-search-v1","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object"},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"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_TeS1MkSLm491ApxO4hj7O","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 a bounded snapshot of the UK Companies House register by company name, number, status, category, address, or SIC code","exampleAgentPrompt":"Can you search the UK Companies House register for 'Barclays PLC' and tell me its company number, current status, registered address, and SIC codes?","exampleUseCases":[{"title":"Due diligence on a UK supplier","prompt":"I need to verify that 'Acorn Digital Solutions Ltd' is a legitimate, active UK company — can you pull its Companies House registration details including status, registered address, and SIC code?"},{"title":"Finding companies by industry sector","prompt":"Search Companies House for UK companies with SIC code 62012 — I want to see what businesses are registered in that software consultancy category."},{"title":"Confirming a company number before filing","prompt":"What is the official Companies House company number and registered address for 'Rolls-Royce Holdings plc'? I need to make sure I have the correct details before submitting a document."}],"resultDescription":"Returns structured company record(s) from the UK Companies House snapshot including company name, company number, status (e.g. active, dissolved), company category (e.g. private limited), registered address, and SIC code(s). Results reflect a bounded snapshot rather than a live real-time feed.","failureModes":["Company not found in snapshot — returns empty results (snapshot may not include very recently incorporated companies)","Ambiguous or misspelled company name — may return no results or unrelated companies","Snapshot staleness — dissolved or recently changed companies may show outdated status","Rate limiting or payment failure — call rejected if x402 payment not completed","Malformed request body — returns validation error if required fields are missing"],"whenToPreferThis":"Choose this endpoint when you need structured UK company registry data (name, number, status, address, SIC) for due diligence, compliance checks, enrichment pipelines, or verification workflows, especially when commercial reuse is required (OGL v3.0 licence). Prefer this over scraping Companies House directly or using live APIs when a bounded snapshot is sufficient and cost-per-call pricing is acceptable. Not ideal for real-time incorporation monitoring or when the very latest filings are critical.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:44:35.708Z","isFirstParty":false}