Search Companies House
company_searchRead-onlyIdempotent
Search Companies House by name or keyword to retrieve company details including status, SIC codes, incorporation date, and registered address. Paginated results.
Instructions
Search the Companies House register by company name or keyword.
Returns a paginated list of matching companies with name, number, status, SIC codes, incorporation date, and registered address. Use company_profile for the full record once you have the company number. Re-call with start_index=start_index+items_per_page to fetch the next page.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Company name or keyword to search for | |
| company_status | No | Filter by company status (e.g. 'active', 'dissolved'). Omit to search all. | |
| company_type | No | Filter by company type (e.g. 'ltd', 'llp'). Omit to search all. | |
| items_per_page | No | Number of results to return (max 100). Default 20. | |
| start_index | No | Pagination offset. Default 0. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The query string that was searched. | |
| total_results | Yes | Total matching companies in Companies House (server-side). | |
| start_index | Yes | Number of results skipped before this page (upstream start_index). | |
| items_per_page | Yes | Page size requested from the API for this call. | |
| returned | Yes | Number of items actually returned on this page. | |
| has_more | Yes | True if more results exist beyond this page. Re-call with start_index=start_index+items_per_page to fetch the next page. | |
| items | No | Matching companies. Use the `company_number` field to call company_profile, company_officers, or company_psc for full detail. |