# UK Companies House Lookup: Company Number, Officers, Status (`pvalyou/uk-companies-house`) Actor

UK Companies House lookup by company number or name: the register's own record with legal name, status, incorporation and dissolution dates, registered address, officers and filings. Read live. $0.005 a company.

- **URL**: https://apify.com/pvalyou/uk-companies-house.md
- **Developed by:** [Pvalyou](https://apify.com/pvalyou) (community)
- **Categories:** Business, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 company records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

[![UK Companies House Lookup](https://apify.com/actor-badge?actor=pvalyou/uk-companies-house)](https://apify.com/pvalyou/uk-companies-house)

**Look up any company in UK Companies House by company number (00445790, SC123456, OC301234) or by name, and get the register's own record.** Registration number, legal name, status, incorporation and dissolution dates and the registered address, from Companies House, the UK register of companies, read live. Officers with their roles, and the company's filings, come with a matched company. $0.005 a company found, nothing when the register holds nothing.

**Try it now with the prefilled input:** a company number and a company name, then type your own over them.

**What you get**

- ✅ **The register's own record.** Every field is the register's value, with the source link and the date it was read, never a copy from a data broker.
- ✅ **Status in plain words.** `active`, `inactive` (dormant, in liquidation or listed for strike-off), `closed` (dissolved), or `unknown`, plus the register's own wording.
- ✅ **Names or numbers.** A number finds the one company. A name returns the best match, or a ranked shortlist when several companies fit, so you can ask again with the right number.
- ✅ **Honest answers.** `no_match` means the register holds nothing under that query and it is free. A register that did not answer is said to be unavailable, never folded into not found.

### 👥 Who uses it

- **KYB and onboarding teams** confirming that a customer or merchant in United Kingdom exists, is active and is registered under the name and number it gave.
- **Supplier and counterparty due diligence** before a contract or a payment run.
- **CRM and data teams** cleaning company records: the official legal name, number and registered address.
- **Lead validation**, so a prospect list holds real, active companies.
- **AI agents** that need a register's own answer, with its source link.

### 📦 Example item

A real `record` item from this Actor's first run. The `officers` list, with each officer's name, role and appointment date, is left out here:

```json
{
  "type": "record",
  "query": "00445790",
  "register": "gb",
  "searched_by": "number",
  "status": "matched",
  "charged": true,
  "charged_event": "registry_record",
  "confidence": 100,
  "registration_id": "00445790",
  "legal_name": "TESCO PLC",
  "entity_status": "active",
  "registration_date": "1947-11-27",
  "city": "Welwyn Garden City",
  "postal_code": "AL7 1GA",
  "display_address": "Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, AL7 1GA, United Kingdom"
}
```

### 🤖 Using this Actor from an AI agent

**Call it when** you need to confirm that a company in United Kingdom exists, or need its official number, legal name, status, address or officers. Smallest useful input:

```json
{"queries": ["00445790"]}
```

Read `status` on the `record` item: `matched` is one company, `ambiguous` lists `candidates`, `no_match` is free.

### 💰 Pricing

$0.005 per company record matched or shortlisted ($0.004 on Silver, $0.003 on Gold), plus $0.00005 to start the run. No match and errors are free.

### 📤 Output

One `record` item per query: `registration_id`, `legal_name`, `entity_status`, `entity_status_raw`, `registration_date`, `dissolution_date`, `registered_address`, `officers` (name, title, role flags), `filings` where published, `source_url`, `source_as_of`, `confidence` and `candidates`. Data under the Open Government Licence v3.

### 🔗 Works well with

For a company registered elsewhere, [Company Registry Lookup](https://apify.com/pvalyou/company-registry-lookup) asks more than 40 official registers with the same input. To check that the company's website is still live, give its domain to [Website Status Checker](https://apify.com/pvalyou/website-liveness-check).

### ❓ Questions

**Other countries?** [Company Registry Lookup](https://apify.com/pvalyou/company-registry-lookup) searches 42 official registers and GLEIF with the same schema, one register at a time or a whole region at once.

**How fresh is the data?** The register is read live on every lookup, so a status change or a new officer shows the day the register records it.

**Can I look up many companies at once?** Yes, one per line. 1,000 companies cost $5 on the Free and Bronze plans, less on Silver and Gold, and a number the register does not hold costs nothing.

**Can I export the results?** As JSON, CSV, Excel or XML from the dataset, or through the Apify API.

**Personal data.** Officer names are personal data that the register publishes under company law. Use them only where you have a lawful basis, such as KYB or due diligence.

# Actor input Schema

## `queries` (type: `array`):

One per line: a company number (00445790, SC123456, OC301234) or a company name. A number finds the one company, a name returns the best match or a ranked shortlist.

## `max_candidates` (type: `integer`):

How many companies a name that fits several may return as a shortlist.

## Actor input object example

```json
{
  "queries": [
    "00445790",
    "Rolls-Royce Holdings plc"
  ],
  "max_candidates": 10
}
```

# Actor output Schema

## `results` (type: `string`):

Every item of the run with every field it carries: register records, error items and search summaries.

## `records` (type: `string`):

Every item of the run, shown as the record columns: register, status, confidence, legal name, registration number, entity status, dates, snapshot date, source URL, the licence the register publishes under, the attribution it requires, charged. A view picks the columns and never drops rows, so search summaries and error items are in this table too, with the record columns they do not carry left blank.

## `summaries` (type: `string`):

Every item of the run, shown as the search-summary columns: registers answered, matched, ambiguous and skipped, and the single best match with its name, number, status, licence and attribution. A view picks the columns and never drops rows, so record rows and error items are in this table too, with the summary columns left blank.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "00445790",
        "Rolls-Royce Holdings plc"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("pvalyou/uk-companies-house").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "queries": [
        "00445790",
        "Rolls-Royce Holdings plc",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("pvalyou/uk-companies-house").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "queries": [
    "00445790",
    "Rolls-Royce Holdings plc"
  ]
}' |
apify call pvalyou/uk-companies-house --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pvalyou/uk-companies-house"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/8pA05BRvRoXdVyqI1/builds/l7yPBxMQxcJMn7MAr/openapi.json
