scrollport
Back to Finance

Company Search

Companies House

Search official UK Companies House records by company name and return identity matches with company numbers and status.

Capability
Companies House API
Current price
$0.0050/call
Availability
Ready to run
Last accepted verification

What this API does

Search the official Companies House public register by company name and return at most 50 normalized matches with company number, name, status, type, incorporation or dissolution dates and canonical register links. The contract omits officers, persons with significant control, charges, insolvency detail, addresses and filing authority.

Agents select this operation with tool ID companies-house.company-search, then inspect its current executable contract before a run.

Public input and output shape

Input

limitinteger · optional

Value supplied for limit.

minimum: 1 · maximum: 50

querystring · required

Search terms used to find relevant records.

minLength: 2 · maxLength: 200

start_indexinteger · optional

Value supplied for start index.

minimum: 0 · maximum: 5000

Output

captured_atstring

Returned captured at value.

itemsarray

Returned items value.

omitted_itemsnumber

Returned omitted items value.

start_indexnumber

Returned start index value.

total_resultsnumber

Returned total results value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "companies-house.company-search",
  "input": {
    "limit": 5,
    "query": "OpenAI"
  }
}

Output

{
  "items": [
    {
      "name": "OPENAI UK LTD",
      "status": "active",
      "source_url": "https://find-and-update.company-information.service.gov.uk/company/14367667",
      "company_type": "ltd",
      "company_number": "14367667",
      "dissolution_date": null,
      "incorporation_date": "2022-09-21"
    }
  ],
  "captured_at": "2026-08-20T00:00:00.000Z",
  "start_index": 0,
  "omitted_items": 0,
  "total_results": 1
}
Teaching errors and limitations
  • invalid_input: query, limit or start_index was outside the bounded Companies House search contract.example: {"query":"OpenAI","limit":5}
Updated
22 August 2026

Use Company Search with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.