{"name":"companies_house_search_companies","description":"Search UK Companies House by company name. Returns matches with company number, name, status (active/dissolved), type, registered office address, and incorporation date. Use the company_number to look up officers, filings, and PSCs.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Company name (full or partial)"},"items_per_page":{"type":"number","description":"1-100 (default 20)"},"start_index":{"type":"number","description":"Pagination offset (default 0)"},"_apiKey":{"type":"string","description":"Optional API key for this data source. Overrides the platform-provided key, or supplies one for BYO-only sources Pipeworx doesn't front. Free keys are available from the upstream provider."}},"required":["query"],"examples":[{"query":"Apple"},{"query":"Tesco PLC","items_per_page":10,"start_index":0}]},"outputSchema":{"type":"object","properties":{"total":{"type":"number","description":"Total number of companies matching the search query"},"returned":{"type":"number","description":"Number of companies returned in this response"},"companies":{"type":"array","description":"List of matching companies","items":{"type":"object","properties":{"company_number":{"type":["string","null"],"description":"UK company number"},"name":{"type":["string","null"],"description":"Company name"},"status":{"type":["string","null"],"description":"Company status (active, dissolved, etc.)"},"type":{"type":["string","null"],"description":"Company type (private limited, public limited, etc.)"},"incorporated_on":{"type":["string","null"],"description":"Incorporation date (ISO format)"},"address":{"type":["string","null"],"description":"Registered office address snippet"},"ch_url":{"type":["string","null"],"description":"Link to company profile on Companies House website"}}}}},"required":["total","returned","companies"]},"annotations":{"readOnlyHint":true,"openWorldHint":true,"destructiveHint":false,"idempotentHint":true,"cost":{"all":2}},"version":"v1.c6d6b064","disclosure":{"cost":{"credits":50,"usd":"$0.0050","category":"gov","plan":"basic","basis":"list"},"auth":{"shape":"platform-keyed","detail":"Pipeworx supplies the companies-house API key — no key needed from you. You may override it with `_apiKey`.","byo_key_optional":true,"key_configured":true},"reliability":{"measured":true,"window_days":7,"golden":{"runs":21,"pass_pct":100}}},"call":"POST https://gateway.pipeworx.io/v1/tools/companies_house_search_companies"}