Filter UK companies by SIC code, postcode, town, status, type and dates, or look them up by number, from the official Companies House free monthly file. Company fields only: no director, officer or care-of names. Snapshot date on every row.
All notable changes to this Actor are recorded here. The format follows Keep a Changelog, and versions follow
Semantic Versioning (MAJOR.MINOR; a breaking output change means a new MAJOR).
[1.0] build 1.0.7 - 2026-11-18
Fixed
A care-of name that went on past a comma was partly kept: "C/O A FIRM, A PERSON A HOUSE" gave "A PERSON A HOUSE".
Now everything after a care-of name is dropped up to the first house number, unit, suite, floor or PO box, so that
example gives an empty line and "C/O A FIRM, A PERSON, 4 HIGH STREET" gives "4 HIGH STREET". A building name
written between the care-of name and the street number is dropped with it.
As in 1.0.6 the stored snapshot is cleaned when rows are output, so no rebuild is needed.
[1.0] build 1.0.6 - 2026-11-18
Fixed
Care-of text inside a registered office line ("C/O ..." or "CARE OF ...") is removed; the rest of the address is
kept. For example "C/O A FIRM 1 HIGH STREET" becomes "1 HIGH STREET", and a line that is only a care-of name is
empty. This applies to registeredOfficeLine1, registeredOfficeLine2, postTown, county, country and
postCode. The care-of name can be a person's name. A 10,000-row check of build 1.0.5 found 212 such rows.
The stored snapshot is cleaned when rows are output, so no rebuild is needed.
Changed
The README JSON examples are shorter so they fit a phone screen. The output example shows some fields only.
[1.0] build 1.0.5 - 2026-11-17
Changed
The default run timeout is now 2 hours (was 1 hour). A full snapshot build took about 53 minutes on build 1.0.4.
The README gives the measured first-run figures: a ~0.65 GB snapshot and around 55 minutes (it said ~0.5 GB and
around 40 minutes). It also says to start one run first after a new monthly file, because two runs started
together both build the snapshot. Output, prices and the stored snapshot are unchanged; no rebuild is needed.
[1.0] build 1.0.4 - 2026-11-17
Fixed
registeredOfficePoBox could hold a care-of entry or a person's name: the file's PO box column is free text. It is
now kept only when the value contains a digit and has no "C/O" or "CARE OF" wording; otherwise it is empty. PO box
numbers, "PO BOX 12"-style values and address fragments such as "SUITE 301" are kept.
Changed
The stored snapshot format is now version 3. A snapshot stored by an earlier build is rebuilt once on the first run
of this build; that rebuild is free, like every snapshot build.
The README says how the start fee depends on run memory.
[1.0] build 1.0.3 - 2026-11-17
Added
Eleven more published columns of the monthly file, so every column is in the output except the care-of name
(it can hold a person's name): registeredOfficePoBox, accountsRefDay, accountsRefMonth,
returnsNextDueDate, returnsLastMadeUpDate, mortgagesTotal, mortgagesSatisfied, mortgagesPartSatisfied,
generalPartners, limitedPartners (partner counts, no names) and companyUri. Existing fields keep their names
and values; the new ones are added to each row.
Changed
The stored snapshot format is now version 2 (longer records). A snapshot stored by an earlier build is rebuilt once
on the first run of this build; that rebuild is free, like every snapshot build.
Fixed
The FAQ wrongly said director and PSC data are not available in bulk. Companies House does publish a PSC bulk
file; the tool leaves director and PSC records out because they are about people.
[1.0] - 2026-11-16
Added
UK companies from the Companies House Free Company Data Product (the free monthly file), one row per company:
number, name, status, type, country of origin, incorporation and dissolution dates, registered office, up to four
SIC codes split into code and label, accounts and confirmation-statement dates, outstanding mortgage charges,
previous names, a link to the company's Companies House page, and the snapshot date.
Search mode with filters: SIC codes or prefixes, postcode areas, districts, sectors or postcodes, post towns,
company status, company type, incorporation dates, overdue accounts and overdue confirmation statements.
Lookup mode: up to 1,000 company numbers; a number that is not in the file gets a free not-found row.
Refresh mode: store the newest monthly snapshot without returning rows.
The monthly file is split once into small shards in a named key-value store, so a run reads only what its filters
need. Building the snapshot is free.
Pay per company delivered; the run stops at your max charge limit.