# UK Companies House Lookup by Company Number

> UK Companies House Lookup by Company Number is a paid API for AI agents from x402-agent-tools.nerolabs.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-22).

Looks up UK company details from Companies House by company number, returning name, status, type, address, incorporation date, SIC codes, and officer information for up to 20 companies per call.

## Facts

- Endpoint: POST https://x402-agent-tools.nerolabs.workers.dev/company/uk?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uk-companies-house-lookup-by-company-number-02084f37
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vmkq-Csrxj1qenTJdIu4Y

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability uk-companies-house-lookup-by-company-number-02084f37 -d '<json body>'
```

Example prompt: Can you look up the Companies House details for company number 00445790 — I need to know the company name, current status, registered address, and who the officers are.

## When to prefer this

Use this endpoint when you need authoritative UK company registry data from Companies House, especially for due diligence, supplier verification, or compliance workflows. It supports batch lookups of up to 20 companies per call at $0.01 each, making it cost-effective for enrichment pipelines. Prefer this over manual Companies House searches or web scraping when you need structured, machine-readable output including officer details and filing due dates.

## Known failure modes

- Company number not found (notFound: true in the row)
- Invalid or malformed company number (not 8 characters)
- Exceeding 20 company numbers per call
- Companies House API unavailability or rate limiting
- Payment failure or insufficient USDC balance

## How this service works

Pay-per-call tools for AI agents, 31 in all: read web pages and RSS feeds, OCR, PDF text, transcription; email, phone and domain checks; UK, Irish and Polish company lookups and UK risk reports; website contacts, tech stack and SEO audits; PageSpeed; AI review, job post and row enrichment; data cleaning, joins, dedupe and diffs; US and EU compliance rules. No account or API key: pay each call in USDC on Base over x402.

## Output

Returns a JSON object with a 'rows' array (one entry per company) and a count. Each row includes: company name, company number, status, type, incorporation date, registered address, SIC codes, accounts due date, confirmation statement due date, officer list, a Companies House URL, change detection fields (changeDetected, changes, changeSummary, isFirstCheck), whether the record was found (notFound flag), and the timestamp of the check (checkedAt).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "companyNumber": {
   "type": "string",
   "description": "Exact 8-character Companies House number, e.g. 03977902. Use this for a single-record lookup."
  },
  "companyNumbers": {
   "type": "array",
   "default": [],
   "description": "A list of exact Companies House numbers. Required for Monitor mode (that's what gives each company a stable identity to track over time). Also the fastest way to check many known companies in one run."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rows": [
   {
    "changes": [],
    "notFound": false,
    "checkedAt": "2026-10-21T14:29:40.118Z",
    "companyName": "TESCO PLC",
    "monitorMode": false,
    "isFirstCheck": true,
    "changeSummary": "Monitor mode is off, this is a one-time lookup.",
    "companyNumber": "00445790",
    "companyStatus": "active",
    "changeDetected": false,
    "companiesHouseUrl": "https://find-and-update.company-information.service.gov.uk/company/00445790"
   }
  ],
  "count": 1,
  "_example_note": "Real output, trimmed: long lists cut to their first items, fields and text shortened."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uk-companies-house-lookup-by-company-number-02084f37/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-agent-tools.nerolabs.workers.dev](https://www.zero.xyz/host/x402-agent-tools.nerolabs.workers.dev/llms.txt)
