Companies House Scraper with Insolvency History

Extracts UK company records from the public Companies House register — and, unlike other Companies House scrapers on the Store, it also returns each company's insolvency history: administrations, liquidations and the details published for every case.

If you do credit risk, B2B due diligence or company monitoring in the UK, that field is usually the reason you opened the register in the first place.

What it does

• Search the register by company name or number and get the matching companies.
• Look up one company by its number and get the full record, including insolvency cases.
• Company results only — officer and disqualified-director entries are filtered out.

Input

Field	Type	Description
query	string	Text to search for in the register. Optional.
companyNumber	string	Company number for a direct lookup with insolvency history. Optional.
maxItems	integer	Maximum number of companies to return. Default 50.

Provide at least one of query or companyNumber.

{ "companyNumber": "03782379" }

Output

One item per company. The two ways in return different depth, because a direct lookup reads the company profile page and a search does not:

Field	Search by query	Lookup by companyNumber
companyNumber	yes	yes
name	yes	yes
status	yes	yes
url	yes	yes
insolvency	yes	yes
incorporatedOn	—	yes
sicCodes	—	yes

insolvency is a list, empty when the register records no proceedings. Each case carries caseNumber, type, a details map of the dates the register publishes, and practitioners with the appointed role and firm. No personal data of individuals is returned: no directors, no persons with significant control, no dates of birth, no residential addresses.

Sample item from a lookup by company number:

{
  "url": "https://find-and-update.company-information.service.gov.uk/company/03782379",
  "companyNumber": "03782379",
  "name": "CARILLION PLC",
  "status": "Liquidation",
  "incorporatedOn": "28 May 1999",
  "sicCodes": [
    "41201 - Construction of commercial buildings",
    "42110 - Construction of roads and motorways"
  ],
  "insolvency": [
    {
      "caseNumber": 1,
      "type": "Compulsory liquidation",
      "details": {
        "Petition date": "15 January 2018",
        "Commencement of winding up": "15 January 2018"
      },
      "practitioners": [
        { "role": "Practitioner", "name": "The Official Receiver Or London" }
      ]
    }
  ]
}

Pricing

Pay per result. You are charged for each company written to the dataset, and the Actor honours the maximum charge you set for a run: if you cap it, it stops writing rather than overrunning.

Data source and limits

Data comes from the public Companies House register, published under the Open Government Licence. The Actor reads the public website at a polite rate and does not collect personal data about individuals: no officers, no persons with significant control, no dates of birth and no residential addresses. Company-level records only.

The register is the source of truth; this Actor reproduces what it publishes and adds no interpretation of its own. Insolvency details are returned as the register presents them.