{"uid":"cap_lY1wkcxF24GmHIkTPjasR","slug":"macaroon-network-companies-house-live-discovery-61c08529","name":"Macaroon Network – Companies House Live Discovery","description":"Discover current UK companies through the official Companies House advanced search using bounded filters for company-name inclusion, status, type, incorporation date range, location, and five-digit SIC code. Returns at most 20 normalized company-level public-register records.","url":"https://api.macaroonnetwork.com/execute/companies-house-live-discovery-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.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LLmeyJWvUX-YZqZa3EVLS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches the official UK Companies House register using advanced filters to return up to 20 normalized company records matching name, status, type, incorporation date range, location, and SIC code.","exampleAgentPrompt":"Search Companies House for active private limited companies in London with SIC code 62012 that were incorporated between January 2020 and December 2022 and whose name includes 'tech'.","exampleUseCases":[{"title":"Industry sector competitor discovery","prompt":"Find me all active UK limited companies in the software development sector — SIC code 62012 — that were incorporated in the last three years and are based in Manchester."},{"title":"Due diligence name search","prompt":"Search Companies House for any UK companies whose name includes 'Apex Capital' — I need their status, company type, registration number, and incorporation date."},{"title":"Market research by geography and SIC","prompt":"I'm researching the UK fintech landscape — can you pull up to 20 active companies registered in Edinburgh with SIC code 64999 incorporated after January 2018?"}],"resultDescription":"Returns up to 20 normalized company-level records from the UK Companies House public register, each containing the company name, company number, status (e.g. active, dissolved), company type, incorporation date, registered office address, and SIC code(s).","failureModes":["No matching companies found for the given filter combination — returns empty result set","Invalid or unsupported SIC code returns an error or empty results","Date range outside valid bounds may cause a validation error","Overly broad queries may be capped at 20 results with no pagination","Payment failure via x402 protocol results in a 402 response and no data returned","Malformed body or missing required fields returns a 400-level error"],"whenToPreferThis":"Choose this endpoint when you need to discover or enumerate UK companies using multiple combined filters (name fragment, status, type, date range, location, SIC code) against the live Companies House register. It is ideal for market research, competitor discovery, due diligence screening, and regulatory lookups where official UK government data is required. Prefer this over a simple name-lookup endpoint when you need to filter by industry sector (SIC), geography, or incorporation date simultaneously.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:31:18.959Z","isFirstParty":false}