Search Companies House
company_searchRead-onlyIdempotent
Search the UK Companies House register by company name or keyword to retrieve matching companies with name, number, status, and registered address.
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 | |
| start_index | No | Pagination offset. Default 0. | |
| company_type | No | Filter by company type (e.g. 'ltd', 'llp'). Omit to search all. | |
| company_status | No | Filter by company status (e.g. 'active', 'dissolved'). Omit to search all. | |
| items_per_page | No | Number of results to return (max 100). Default 20. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | No | Matching companies. Use the `company_number` field to call company_profile, company_officers, or company_psc for full detail. | |
| query | Yes | The query string that was searched. | |
| 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. | |
| returned | Yes | Number of items actually returned on this page. | |
| start_index | Yes | Number of results skipped before this page (upstream start_index). | |
| total_results | Yes | Total matching companies in Companies House (server-side). | |
| items_per_page | Yes | Page size requested from the API for this call. |