GovData Labs — UK Companies House Enrichment

Two jobs on the official Companies House REST API:

• Enrich a list of company numbers or names. Each output row carries the profile, registered address, SIC codes, status, incorporation date, accounts and confirmation-statement due dates, officers, persons with significant control, and a charges summary. Turn any of those sections off.
• New incorporations for a date range, optional SIC codes, and an optional location, using the advanced search endpoint. The streaming API is available when you already have a timepoint and want to follow the firehose forward.

For developers, lenders, sales teams, and compliance tools that need a flat UK company record without paging the Companies House website.

You supply the API key. This Actor does not create one.

What you get

One record per company:

• company_number, company_name, normalized_name, match_confidence, match_method
• company_status, company_type, incorporation_date, jurisdiction, sic_codes
• registered_address
• accounts_next_due, accounts_overdue
• confirmation_statement_next_due, confirmation_statement_overdue
• has_charges, has_insolvency_history
• officer_count, active_officer_count, officers
• psc_count, persons_with_significant_control
• charges_total, charges_outstanding, charges_satisfied, charges
• source_url on the public company page, and fetched_at

Officers, PSCs, and charges are arrays on that same record. The Output tab has an officers view that unwinds them. Sections you turn off are null and are not requested, which saves quota.

Name search picks the best fuzzy match and returns up to three companies when the scores are within 0.03 of each other. Active companies get a small score boost. Anything under the threshold (default 0.84) is listed in the run summary as unmatched and is not billed as a result.

Pricing

Pay per event. You pay only for what a run returns:

Event	Price	When
actor-start	$0.010	Once per valid run
company-result	$0.020	Each output row, whether it came from enrichment or the incorporations feed
change-detected	$0.005	Each new or changed row after a baseline snapshot

The default enrichment cap is 25 companies, about $0.51. One thousand full enrichments are about 5,000 API calls. The client stays at 500 requests per 5 minutes so a shared key still has room under the official 600 / 5 minutes limit. That run is about 50 minutes at 512 MB, roughly 0.42 compute units of platform usage, billed separately by Apify.

A thousand incorporation rows from advanced search are usually 10 to 20 requests. Same event price, much less compute.

Example input

Enrichment:

{
  "mode": "enrich",
  "companyNumbers": ["00445790"],
  "companyNames": ["Northwind Analytics"],
  "apiKey": "YOUR_KEY",
  "includeOfficers": true,
  "includePersonsWithSignificantControl": true,
  "includeCharges": true,
  "maxResults": 25
}

Incorporations:

{
  "mode": "incorporations",
  "apiKey": "YOUR_KEY",
  "incorporatedFrom": "2026-10-01",
  "incorporatedTo": "2026-10-31",
  "sicCodes": ["62012"],
  "location": "London",
  "enrichIncorporations": false,
  "maxResults": 100
}

Stream follow-up (not a historical backfill):

{
  "mode": "incorporations",
  "incorporationSource": "stream",
  "streamTimepoint": 424242,
  "apiKey": "YOUR_KEY",
  "maxResults": 50
}

The run output includes nextTimepoint for the next poll.

Example output

Shape produced from the public API. This fixture is synthetic except for the field names, which match the live API.

{
  "company_number": "12345678",
  "company_name": "NORTHWIND ANALYTICS LTD",
  "company_status": "active",
  "company_type": "ltd",
  "incorporation_date": "2024-03-01",
  "sic_codes": ["62012"],
  "registered_address": "1 High Street, London, SW1A 1AA",
  "accounts_next_due": "2026-12-31",
  "accounts_overdue": false,
  "confirmation_statement_next_due": "2026-03-15",
  "officer_count": 1,
  "charges_outstanding": 1,
  "officers": [
    { "name": "SMITH, Jane", "role": "director", "appointed_on": "2024-03-01", "resigned_on": null }
  ],
  "source_url": "https://find-and-update.company-information.service.gov.uk/company/12345678",
  "fetched_at": "2026-10-31T00:00:00.000Z"
}

Limits

• Official quota: 600 requests per 5 minutes per API key. This Actor defaults to 500.
• 2,000 output rows per run. Related lists are capped at 50 items each (configurable up to 100).
• Advanced search is the way to backfill a date range. The stream starts at streamTimepoint and stops after maxStreamEvents (default 2,000) so it cannot replay the whole register.
• HTTP 429 and 5xx are retried with backoff. HTTP 401 means the key was rejected.

API key

Create a free key at Companies House developer applications and paste it into the apiKey input. It is stored as a secret input and is not logged.

Data source and licence

Companies House REST API, https://api.company-information.service.gov.uk, and the streaming host https://stream.companieshouse.gov.uk.

Contains public sector information licensed under the Open Government Licence v3.0. © Crown copyright.

Disclaimer

Data comes from official public sources and may lag the registrar. It is not a legal determination of company status, filing obligations, or who controls the company. Confirm anything material on the Companies House register.