Daily release
Each day RecoupIQ signs one small file. The file shows that the company data was updated that day. Each file also links to the file of the day before, so anyone can check the chain.
No release file yet
The first release file appears after the next daily update. Please check again later.
Open datasets
RecoupIQ publishes three open datasets. They hold dated company facts only. A row states what the public register said on its record date. It is not a credit rating. The files hold no scores, no money figures and no names of people.
Licence: CC-BY-4.0. The register data underneath is under the Open Government Licence v3.0.
Source: RecoupIQ Ltd UK company facts, derived from Companies House and The Gazette. Contains public sector information licensed under the Open Government Licence v3.0.
Access. The daily changes files, the dataset cards and the signed release file are open. They need no key. The full company facts file and the full notices file need a free API key. A request with no key gets HTTP 401. Get a free key at /developers and send it as a Bearer token. Read the terms of use.
The first open dataset release appears after the next daily update. Please check again later.
Columns
Company facts (full file and daily changes)
company_number(string): Companies House company number.company_name(string): Registered company name.jurisdiction(string): Always gb.company_status(string): Company status text on the register.company_type(string): Company type text on the register.country_of_origin(string): Country of origin on the register.incorporation_date(date): Date of incorporation.dissolution_date(date): Date of dissolution.sic_codes(list): SIC codes. In CSV the codes are joined with a pipe.sic_texts(list): SIC code texts. In CSV the texts are joined with a pipe.sic_text_1(string): The first SIC text.registered_post_town(string): Post town of the registered office. Empty for overseas companies and when the register value holds street text. No street address.registered_postcode_outward(string): Outward part of the registered office postcode. Empty when it does not look like a UK outward code.accounts_last_made_up_to(date): Date to which the last accounts were made up.accounts_next_due(date): Date the next accounts are due.accounts_category(string): Accounts category on the register.accounts_overdue(boolean): True when the register shows the accounts as overdue.confirmation_statement_last_made_up_to(date): Date to which the last confirmation statement was made up.confirmation_statement_next_due(date): Date the next confirmation statement is due.confirmation_statement_overdue(boolean): True when the register shows the confirmation statement as overdue.charges_total(integer): Number of charges on the register.charges_outstanding(integer): Number of outstanding charges.charges_satisfied(integer): Number of satisfied charges.current_director_count(integer): Count of current directors. No names.previous_names(objects): Earlier company names with the date of change. In CSV each item reads name (YYYY-MM-DD), joined with a pipe.formal_insolvency_notice_type(string): Gazette notice type, only when it is a formal insolvency type.formal_insolvency_notice_date(date): Gazette date of that notice.register_filing_form(string): The latest form in the Companies House liquidation and insolvency register. The register also holds forms of solvent liquidations.register_filing_form_date(date): Date of that form.register_filing_is_formal_insolvency(boolean): True only when the form code is on the allow list AM, CVA, WU plus digit, RESE, LIQ02, LIQ14 or RCVL.record_date(date): The day RecoupIQ last built this record from its copy of the register. The row states what the register said on this day.valid_until(date): The record date plus one day.row_hash(string): SHA-256 of the row without record_date, valid_until and row_hash. It changes only when a fact changes.source(string): Publisher of the file.record_url(string): RecoupIQ page of the company.companies_house_url(string): Companies House page of the company.licence(string): Licence of this file.source_licence(string): Licence of the underlying register data.
Formal insolvency notices
notice_id(string): Gazette notice identifier.company_number(string): Companies House company number.company_name(string): Company name from the Companies House register, or from the stored company profile when the register file has no row. It never comes from the notice text.company_status(string): Company status from the register, or from the stored profile (for example Dissolved) when the register file has no row.company_record_source(string): Where the name and the status come from: register or stored_profile.notice_type(string): Gazette notice type. Empty when the value is not on the fixed list of notice types.category_code(string): Gazette category code.category_group(string): Group derived from the category code only: administration, receivership, creditors_voluntary_liquidation or winding_up_by_the_court.publication_date(date): Day the notice was published.held_by_recoupiq_at(string): Time RecoupIQ stored the notice (ISO 8601).gazette_url(string): Link to the notice page on thegazette.co.uk. Empty when none.source(string): Publisher of the file.licence(string): Licence of this file.source_licence(string): Licence of the underlying register data.
Corrections and removal
The datasets hold company records only. A company or a person can ask for a correction or a removal at contact@recoup-iq.tech. The daily files are written after each successful daily run, so a correction in the source register flows through. The full files are rebuilt from time to time, and each file shows its release date.
How to check the signature
- Download the file from /daily/release.json.
- Get the public key from /api/trust-credential/keys.
- Remove the proof block from the file. Write the rest as canonical JSON (RFC 8785).
- Check the proof value with the Ed25519 public key.
The signed file shows counts and hashes only. The full detail for each company (history, analysis and further registers) is available under licence. contact@recoup-iq.tech.