UK Companies House Companies, Officers and Filings

Search UK companies by name or keyword and export company profiles, with optional officers and filing-history metadata. Uses anonymous public Companies House pages by default. It does not download documents, retrieve PSCs, or verify the accuracy of information filed with Companies House.

Default input searches tesco and saves up to 10 company profiles. No key or account is required. For direct lookups use mode: "companies" and companyNumbers: ["00445790"]; official overview URLs are also accepted. status accepts active, dissolved or all. Search collects up to maxCompanies companies before applying the status filter, so filtered runs may return fewer companies.

Enable includeOfficers or includeFilings for additional rows, bounded separately by maxOfficersPerCompany and maxFilingsPerCompany. Output rowType is company, officer or filing; each row has companyNumber and a canonical source url. Dates use ISO 8601. Fields absent from the source are null. Filing category is null on HTML pages; filingType contains the displayed code. Document links are supplied without downloading the document.

An optional secret apiKey switches all requests to the official Companies House REST API. Obtain a free API key through the Companies House developer hub. API SIC descriptions may be null; filing descriptions are official API description identifiers. The actor never logs the key.

Privacy: no dates of birth (including month/year), no individual officer personal or correspondence addresses, and no individual PSC rows. All PSC rows are omitted. Company registered office addresses are included.

Results save incrementally by company and officer/filing page. Blocked or unavailable targets appear in the final status. Saved rows allow partial success; an all-failed run with no rows fails plainly. Empty search results require two requests. The timeout reserves 20 seconds for shutdown. Search pagination is bounded by maxCompanies; the source may impose additional result limits. No CAPTCHA solving, login or paid API is used.

Run locally: install requirements.txt and run python -m src. Offline tests: python -m unittest discover -s tests after installing requirements-dev.txt. This is a repo-only actor; no production deployment or price has been configured.

Output example

{"rowType":"company","companyNumber":"00445790","url":"https://find-and-update.company-information.service.gov.uk/company/00445790","name":"TESCO PLC","status":"Active"}

The default memory is 512 MB. If start-event billing is configured at publication, it applies per GB of memory: a default 512 MB run is one start event. This repository build sets no prices.

Occupation is unavailable on the anonymous HTML officer pages checked; it is null on that route. The optional official API returns occupation when supplied.