{"uid":"cap_SaMnCT1Anj2ilKwpmGWKZ","slug":"oromi-uk-business-search-b7fa2182","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://agents.oromi.co.uk/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_1tG-rXWCwfFhFGcvkIyYc","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 data by company name or keyword and return matching registered business records","exampleAgentPrompt":"Can you search the UK Companies House register for companies matching 'artisan bakery' and show me up to 20 results with their registration numbers and status?","exampleUseCases":[{"title":"Verify a supplier's UK registration","prompt":"I need to check if 'Greenleaf Logistics Ltd' is a real registered UK company before we sign a contract — can you look it up on Companies House and tell me its registration number and whether it's active?"},{"title":"Due diligence on a potential partner","prompt":"We're considering partnering with a firm that says they're called 'Apex Digital Solutions' — can you search the UK company register for that name and give me any matches, including their company numbers?"},{"title":"Market research for UK competitors","prompt":"Can you search the UK business register for companies with 'renewable energy' in their name and give me up to 50 results so I can see who's operating in that space?"}],"resultDescription":"Returns a JSON object containing the search query, total number of matching companies, and an array of up to 50 company records each including company name, company registration number, and active/inactive status.","failureModes":["Missing required query parameter 'q' returns a validation error","Query returns zero results if no companies match the keyword","Payment failure via x402 protocol returns HTTP 402 with payment details","Rate limits or quota exhaustion may result in errors","Very common keywords may return truncated result sets at the max 50 cap"],"whenToPreferThis":"Choose this endpoint when you need to search UK-registered businesses by name or keyword against the official Companies House registry, especially in a machine-payable agentic context using the x402 USDC micropayment protocol. Prefer it over scraping Companies House directly or using unofficial sources when you need clean structured JSON output with company number and status. Best for due diligence, supplier verification, market research, and compliance workflows focused specifically on UK entities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:44:05.244Z","isFirstParty":false}