UK Companies House Search
Pricing
from $2.00 / 1,000 company fetcheds
UK Companies House Search
Search the official UK Companies House registry for company profiles, directors, officers, filing history, and registered addresses.
UK Companies House Search
Pricing
from $2.00 / 1,000 company fetcheds
Search the official UK Companies House registry for company profiles, directors, officers, filing history, and registered addresses.
Record Type
recordType
Optional
Discriminator: 'company' (a scored company), 'summary' (run rollup), 'unresolved' (a batch query that matched no company), 'info' (no-result note), 'error'.
Failure Type
failureType
Optional
On info/error records only: 'no-data' (query matched nothing), 'invalid-input' (missing query or API key), 'parse-error' (unexpected runtime failure).
Schema Version
schemaVersion
Optional
Output contract version (semver). Consumers branch on shape changes.
Company Number
companyNumber
Optional
Companies House registration number
Company Name
companyName
Optional
Registered company name
Verdict
verdict
Optional
Compliance verdict (additive enum): active-good-standing | active-with-warnings | dormant | in-insolvency | dissolved | unknown.
Risk Score
riskScore
Optional
0-100 KYB risk score from deterministic registry-fact flags (higher = more risk).
Risk Level
riskLevel
Optional
Risk band (additive enum): low | medium | high | critical.
Risk Grade
riskGrade
Optional
A-F grade, inverse of the risk score (A = lowest risk).
Recommended Action
recommendedAction
Optional
Operational routing (additive enum, never advice): proceed | review | enhanced-due-diligence | manual-review | archive.
Compliance Flags
complianceFlags
Optional
Stable enum flags: COMPANY_DISSOLVED, IN_LIQUIDATION, IN_ADMINISTRATION, IN_RECEIVERSHIP, VOLUNTARY_ARRANGEMENT, INSOLVENCY_HISTORY, ACCOUNTS_OVERDUE, CONFIRMATION_STATEMENT_OVERDUE, HAS_CHARGES, REGISTERED_OFFICE_IN_DISPUTE, UNDELIVERABLE_ADDRESS, RECENTLY_INCORPORATED, DORMANT, PSC_MISSING, NO_INDIVIDUAL_PSC, CORPORATE_PSC, FOREIGN_CORPORATE_PSC, PSC_RECENTLY_CEASED, MAJORITY_CONTROL, OUTSTANDING_CHARGES, RECENT_NEW_CHARGE, RECENT_DIRECTOR_RESIGNATION, RECENT_NAME_CHANGE, ACCOUNTS_FILED_LATE, SOLE_DIRECTOR, ALL_DIRECTORS_RESIGNED, MULTIPLE_DIRECTORSHIPS, HIGH_DIRECTOR_TURNOVER, RECENT_MANAGEMENT_INSTABILITY.
Risk Factors
riskFactors
Optional
Human-readable label per triggered compliance flag.
Score Breakdown
scoreBreakdown
Optional
Auditable per-factor contribution to the risk score: [{ factor, label, points }], sorted by points. The score is the sum, capped at 100.
Risk Policy
riskPolicy
Optional
The policy used to weight the score: balanced | onboarding | supplier | credit | minimal.
Risk Policy Version
riskPolicyVersion
Optional
Version stamp of the scoring weights, for reproducibility.
Verdict Reason
verdictReason
Optional
Plain-English reasons behind the verdict.
Summary
summary
Optional
Plain-English one-line summary an LLM can quote.
Match Confidence
matchConfidence
Optional
0-100 confidence the result matches the query (100 for an exact company-number lookup).
Exact Match
exactMatch
Optional
True when the query exactly matched this company.
Status
companyStatus
Optional
Company status
Status Detail
companyStatusDetail
Optional
Additional status detail from the registry, when present.
Type
companyType
Optional
Company type
Jurisdiction
jurisdiction
Optional
Registration jurisdiction (england-wales, scotland, northern-ireland).
Incorporated
dateOfCreation
Optional
Date of incorporation
Ceased
dateOfCessation
Optional
Date of cessation, if applicable
Age (Years)
ageYears
Optional
Years since incorporation.
Company Number Format
companyNumberFormat
Optional
Structural validation of the company number: { valid, scheme }. UK CRNs carry no check digit, so this is format only.
Accounts Overdue
accountsOverdue
Optional
Whether the annual accounts are overdue.
Accounts Next Due
accountsNextDue
Optional
Due date of the next annual accounts.
Confirmation Statement Overdue
confirmationStatementOverdue
Optional
Whether the confirmation statement is overdue.
Confirmation Statement Next Due
confirmationStatementNextDue
Optional
Due date of the next confirmation statement.
Registered Office In Dispute
registeredOfficeInDispute
Optional
Whether the registered office address is in dispute.
Undeliverable Address
undeliverableAddress
Optional
Whether the registered office address is undeliverable.
Previous Names
previousNames
Optional
Former registered company names.
Registered Office Address
registeredOfficeAddress
Optional
Registered office address of the company
SIC Codes
sicCodes
Optional
Standard Industrial Classification codes
Charges
hasCharges
Optional
Whether the company has charges registered
Insolvency
hasInsolvencyHistory
Optional
Whether the company has insolvency history
PSC / Beneficial Ownership Summary
pscSummary
Optional
When includePsc: { hasPsc, activePscCount, ceasedPscCount, corporatePscCount, individualPscCount, ownershipBands[], controlFlags[] }.
Charges Summary
chargesSummary
Optional
When includeCharges: { totalCharges, outstandingCharges, satisfiedCharges, latestChargeDate, latestSatisfiedDate }.
Filing Summary
filingSummary
Optional
When includeFilings: { latestAccountsDate, latestConfirmationStatementDate, latestOfficerChangeDate, filingCategoriesSeen[] }.
Officer Network Summary
officerNetworkSummary
Optional
When includeOfficerAppointments: { activeDirectors, directorsWithMultipleAppointments, totalActiveExternalAppointments, possibleSerialDirector }.
Director Churn
directorChurn
Optional
When includeOfficers: { last12MonthsAppointed, last12MonthsResigned, score (0-100) }. High churn flags RECENT_MANAGEMENT_INSTABILITY / HIGH_DIRECTOR_TURNOVER.
Ownership Complexity
ownershipComplexity
Optional
When includePsc: { score (0-100), level (low/medium/high) } from PSC count, corporate/foreign ownership, and ownership churn.
Health Timeline
timeline
Optional
When includeFilings: chronological [{ date, event, description }] of filing events (NEW_DIRECTOR, DIRECTOR_RESIGNED, NEW_CHARGE, CHARGE_SATISFIED, ACCOUNTS_FILED, CONFIRMATION_STATEMENT_FILED, NAME_CHANGED, ADDRESS_CHANGED, OTHER_FILING).
Health Trend
healthTrend
Optional
When includeFilings: improving | stable | deteriorating | insufficient-data, from the balance of positive vs negative recent events.
Relationship Summary
relationshipSummary
Optional
When includeRelationshipAnalysis: { sharedDirectors, connectedCompanies } — how many active directors hold other appointments and how many distinct other companies they connect to.
Connected Companies
connectedCompanies
Optional
When includeRelationshipAnalysis (full output profile): [{ companyNumber, companyName, companyStatus, relationship: 'shared-director', viaDirector }] — other companies reachable via a shared director.
Early-Warning Signals
earlyWarningSignals
Optional
Deterministic plain-English signals of emerging risk (director churn increasing, new secured lending, accounts repeatedly filed late, recent ownership change). Present only when ≥1 fires.
Anomaly Flags
anomalyFlags
Optional
Registry patterns that stand out: HIGH_OFFICER_TURNOVER, NO_PSC_DECLARED, FREQUENT_NAME_CHANGES, NEW_COMPANY_WITH_SECURED_DEBT, DORMANT_WITH_CHARGES, SOLE_DIRECTOR_NO_PSC, FOREIGN_CORPORATE_CONTROL. Present only when ≥1 fires.
Company Fingerprint
companyFingerprint
Optional
Compact multi-axis dashboard view (0-100 each): { stability, ownershipComplexity, managementStability, financialPressure, registryRisk }. Most complete when enrichment is enabled.
Red Flags
redFlags
Optional
Investigator-style plain-English red flags consolidated from the strongest signals. Present only when ≥1 fires.
Risk Narrative
riskNarrative
Optional
One-line deterministic plain-English summary of the verdict + the red flags (paste-ready).
Alert Severity
alertSeverity
Optional
On watchlist runs: critical | high | medium | low | none, derived from the event set so webhook consumers branch on one field.
Graph Nodes
graphNodes
Optional
When includeGraphEdges (full profile): [{ id, label, type }] for companies + directors, ready for Neo4j / Gephi.
Graph Edges
graphEdges
Optional
When includeGraphEdges (full profile): [{ source, target, relationship, via }] appointment edges.
Sector Comparison
sectorComparison
Optional
When includeSectorComparison: { sic, totalInSector, agePercentile, note }. Honest age-percentile vs the SIC population by incorporation date; director-count and risk percentiles are NOT computed (the API exposes no such filter).
Officers
officers
Optional
Company officers and directors (when includeOfficers is enabled and outputProfile is full)
Active Officers
activeOfficerCount
Optional
Count of active (not resigned) officers (when includeOfficers is enabled).
Resigned Officers
resignedOfficerCount
Optional
Count of resigned officers (when includeOfficers is enabled).
Recent Filings
recentFilings
Optional
Recent filing history (when includeFilings is enabled and outputProfile is full)
Change Flag
changeFlag
Optional
Watchlist diff vs last run (additive enum): NEW | RESOLVED | ESCALATED | DOWNGRADED | UNCHANGED.
Previous Risk Score
previousRiskScore
Optional
Risk score from the last watchlist run.
Risk Delta
riskDelta
Optional
Change in risk score since the last watchlist run.
Change Reason
changeReason
Optional
Plain-English reasons for the change flag.
Events
events
Optional
Typed corporate events since the last watchlist run: STATUS_CHANGED, BECAME_DISSOLVED, ENTERED_INSOLVENCY, COMPANY_RESTORED, DORMANT_STATUS_CHANGED, NEW_CHARGE_REGISTERED, CHARGE_SATISFIED, INSOLVENCY_HISTORY_APPEARED, ACCOUNTS_NOW_OVERDUE, CONFIRMATION_STATEMENT_NOW_OVERDUE, DIRECTOR_APPOINTED, DIRECTOR_RESIGNED, NEW_PSC, PSC_REMOVED, ADDRESS_CHANGED, NAME_CHANGED, RISK_ESCALATED, RISK_IMPROVED. (Director/PSC/charge/address/name events require the matching enrichment to be enabled.)
First Seen At
firstSeenAt
Optional
When this company was first seen on the watchlist.
Runs Seen
runsSeen
Optional
Number of watchlist runs this company has appeared in.
Companies House URL
companiesHouseUrl
Optional
Link to Companies House page