# Changelog of UK Companies House Company List & Lookup (bulk, cheap) (`gapforge/uk-company-list`) Actor

- **URL**: https://apify.com/gapforge/uk-company-list/changelog.md
- **Full Actor documentation**: https://apify.com/gapforge/uk-company-list.md

## Changelog

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.
