UK Company Intelligence

UK Company Intelligence

UK company lookup and enrichment using Companies House data — structured for coding agents, MCP clients, onboarding flows and B2B enrichment.

Use this Actor when you need:

• company number lookup / name search with ranked candidates
• live company status, SIC codes and filing deadlines
• transparent status signals (overdue accounts, charges, insolvency history, and similar)
• company filing history as classified company events
• one-shot UK company enrichment
• company verification (field consistency — not KYC)
• batch enrichment for supplier onboarding (up to 20 companies)

Privacy-first: legal entities only. No directors, PSC or personal data.

Important: Unofficial community Actor. Not affiliated with, endorsed by, or sponsored by Companies House or GOV.UK. Not legal, credit, AML or KYC advice.

---

How to call it

Send operation plus fields. One run = one operation.

{
  "operation": "enrich_uk_company",
  "success": true,
  "data": {},
  "warnings": [],
  "assumptions": [],
  "sources": [],
  "generatedAt": "2026-08-08T12:00:00.000Z"
}

Failures: success: false and error: { code, message, missingInformation }.

Ambiguous names: the Actor will not silently pick a company. Expect ranked candidates or AMBIGUOUS_COMPANY_NAME, then retry with a company number.

---

Operations

Operation	When to use	Notes
resolve_uk_company	Name or number → candidates	Exact number is deterministic; names are ranked
get_company_profile	Full corporate profile	Does not invent financial metrics
get_company_status_signals	Interpretable flags with evidence	No overall “good/bad company” score
get_company_events	Material filings / notices	Deterministic classification (not LLM)
enrich_uk_company	Default one-call enrichment	Identity + profile + signals + events
verify_uk_company	Check expected status / SICs	Consistency only — never “KYC passed”
batch_enrich_uk_companies	Up to 20 companies	Default omits events unless requested

Quick map for agents

Intent	Prefer
“What’s the company number for X Ltd?”	resolve_uk_company
“Is this company active / overdue?”	get_company_status_signals or enrich_uk_company
“Recent material filings”	get_company_events
“Enrich this supplier”	enrich_uk_company
“Does status match what they claim?”	verify_uk_company
“Enrich these suppliers”	batch_enrich_uk_companies

---

Example inputs

Resolve

{
  "operation": "resolve_uk_company",
  "query": "00000006",
  "maxResults": 10,
  "activeOnly": false
}

Enrich (recommended default)

{
  "operation": "enrich_uk_company",
  "companyName": "Example Software Limited",
  "includeEvents": true,
  "lookbackMonths": 12
}

Prefer a company number when you have one:

{
  "operation": "enrich_uk_company",
  "companyNumber": "01234567",
  "includeEvents": true,
  "lookbackMonths": 12
}

Status signals

{
  "operation": "get_company_status_signals",
  "companyNumber": "01234567"
}

Signals may include codes such as ACTIVE, DISSOLVED, ACCOUNTS_OVERDUE, CONFIRMATION_STATEMENT_OVERDUE, HAS_CHARGES, HAS_INSOLVENCY_HISTORY.

Verify

{
  "operation": "verify_uk_company",
  "companyNumber": "01234567",
  "expectedStatus": "active",
  "expectedSicCodes": ["62012"]
}

Batch

{
  "operation": "batch_enrich_uk_companies",
  "companies": [
    { "companyNumber": "00000006" },
    { "companyName": "Example Software Limited" }
  ],
  "includeEvents": false
}

Maximum 20 companies per call (BATCH_LIMIT_EXCEEDED if over).

---

Privacy & scope

Included: registered identity, status, SICs, accounts/confirmation deadlines, charges/insolvency flags, classified filings without person-level detail.

Not included: directors, PSC, residential addresses, personal insolvency, contact harvesting, credit scores, KYC/AML certification.

Optional Gazette corporate notices may appear as enrichment; if unavailable you typically get a warning, not a failed run.

---

Errors to handle

Code	Meaning
INVALID_COMPANY_NUMBER	Number format is invalid
COMPANY_NOT_FOUND	No match
AMBIGUOUS_COMPANY_NAME	Ask for / supply a company number
INVALID_LOOKBACK	Invalid lookbackMonths
BATCH_LIMIT_EXCEEDED	More than 20 companies
COMPANIES_HOUSE_RATE_LIMITED	Upstream rate limit — retry later
COMPANIES_HOUSE_UNAVAILABLE	Upstream temporarily unavailable

---

Keywords

UK company lookup · Companies House API · UK company enrichment · company number lookup · company status · company verification · company filing history · accounts overdue · confirmation statement overdue · company events · company intelligence · supplier onboarding · B2B enrichment · AI agent company lookup · MCP