{"uid":"cap_EDokd-XkcmIEc5VzgtdFv","slug":"runonproof-uk-companies-house-entity-resolver-eb31bb28","name":"RunOnProof UK Companies House Entity Resolver","description":"Resolve a UK Companies House entity before onboarding or contracting. Use a company number, or a legal name with optional postcode, to obtain source-scoped identity candidates. Ambiguity returns REVIEW; it does not imply good standing.","url":"https://cdo-production.up.railway.app/v1/gb/entities/resolve","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"postal_code":{"type":"string","maxLength":20},"company_name":{"type":"string","maxLength":300,"minLength":2},"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."}}},"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_2G9rzC_4sNDAM0xY6qfcB","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":"Resolves a UK company's identity using Companies House data given a company number or legal name, returning candidate matches or a REVIEW flag on ambiguity.","exampleAgentPrompt":"Can you resolve the UK Companies House identity for 'Acme Widgets Ltd' with postcode SW1A 1AA before we onboard them as a supplier — use company name and postcode to find the right registered entity?","exampleUseCases":[{"title":"Supplier onboarding identity check","prompt":"We're about to onboard a new UK supplier called 'Greenfield Engineering Ltd' based in Manchester — can you pull their Companies House identity record using their name and postcode M1 2AB to make sure we have the right legal entity before we sign anything?"},{"title":"Contract counterparty verification","prompt":"Before we finalise this contract, can you look up the UK company with Companies House number 03977902 and confirm the registered legal name and identity details?"},{"title":"Resolving ambiguous company name","prompt":"I need to identify the correct registered company behind 'Atlas Holdings' in the UK — there might be more than one, so please search by name and postcode EC2A 4NE and let me know if it comes back as ambiguous."}],"resultDescription":"Returns one or more identity candidate records sourced from Companies House, each containing registered company details scoped to the Companies House source. If the name/postcode combination is ambiguous, the response includes a REVIEW status rather than a definitive match. A unique company number query typically returns a single resolved record.","failureModes":["Ambiguous name returns REVIEW status rather than a single resolved entity — caller must refine search or use company number","Invalid company number format rejected by schema validation","No matching entity found for the given name or number","Service unavailable or upstream Companies House API timeout","Idempotency key mismatch if header and body values differ"],"whenToPreferThis":"Use this endpoint when you need to resolve the legal identity of a UK-registered company prior to onboarding, contracting, or payment — especially when you have a company number or a legal name with a postcode. Prefer this over general web search when you need authoritative Companies House source-scoped identity data with structured candidate output and ambiguity signalling.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:39:44.466Z","isFirstParty":false}