{"uid":"cap_VixL2moulGyTOiCK0RQvP","slug":"oromi-uk-business-search-d63607d6","name":"Oromi UK Business Search","description":"Machine-payable APIs for AI agents, paid per call in USDC via the x402 protocol: UK business data (Companies House), UK property market data (HM Land Registry), website agent-readiness audits, and crypto market context.","url":"https://oromi-agent-services.onrender.com/api/uk-business/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","description":"Company name or keyword to search"},"items":{"type":"string","description":"Max results (default 10, max 50)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"items":[{"status":"active","company_name":"ARTISAN BAKERY LTD","company_number":"12345678"}],"query":"artisan bakery","total_results":42}},"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_uuXS0EJkNVqE0J_Z1W_BA","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 the UK Companies House registry by company name or keyword and return matching company records including status and company number.","exampleAgentPrompt":"Can you search Companies House for UK companies matching 'artisan bakery' and return up to 20 results with their company numbers and status?","exampleUseCases":[{"title":"Verify a supplier's UK registration","prompt":"I need to check whether a company called 'Greenfield Construction Ltd' is a registered and active UK business — can you look it up on Companies House and get me their company number?"},{"title":"Research competitors in a UK sector","prompt":"Find me up to 30 UK companies with 'renewable energy' in their name so I can see who's registered in that space."},{"title":"Due diligence before a partnership","prompt":"Before we sign with them, can you search Companies House for 'Apex Media Solutions' and tell me if they're active and what their registered company number is?"}],"resultDescription":"A JSON array of matching company records, each containing the company name, company number, and current status (e.g. active or dissolved), along with the original query string and total number of results found in the registry.","failureModes":["Missing required query parameter 'q' returns a validation error","No matching companies found returns an empty items array with total_results 0","Payment failure via x402 protocol blocks access and returns HTTP 402","Render hosting cold-start may cause slow initial response or timeout","Overly generic search keyword may return up to 50 results with low relevance"],"whenToPreferThis":"Choose this endpoint when you need programmatic, pay-per-call access to UK Companies House data without setting up your own API key or OAuth flow with Companies House directly. Ideal for AI agents that need to verify UK business registrations, look up company numbers, or check company status on demand, and can pay micro-amounts in USDC via x402. Prefer this over scraping or manual lookup when operating in an automated pipeline.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:33:25.205Z","isFirstParty":false}