United Kingdom

Companies House register (UK)

Companies in the official monthly basic company snapshot by status, type, town, postcode, SIC code and incorporation date. Download a list, call the API, or connect an agent. 5,704,711 rows. Licence: Crown copyright (Companies House reuse terms). Example: Active companies incorporated in Leeds since 1 January 2026, as CSV: https://datascoop.io/v1/datasets/companies-house/query?status=Active&postTown=Leeds&incorporatedSince=2026-01-01

get/v1/datasets/companies-house/query

Request

  • Base URL: https://datascoop.io
  • URL: https://datascoop.io/v1/datasets/companies-house/query
  • Auth: one of:
    • none
    • HTTP bearer
    • API key in query parameter api_key

Query parameters

status'Active' | 'Active - Proposal to Strike off' | 'Liquidation' | 'In Administration' | 'Live but Receiver Manager on at least one charge' | 'Voluntary Arrangement' | 'In Administration/Administrative Receiver' | 'RECEIVERSHIP' | 'ADMINISTRATION ORDER' | 'ADMINISTRATIVE RECEIVER'

Status: exact match, case-insensitive.

category'Private Limited Company' | 'PRI/LTD BY GUAR/NSC (Private, limited by guarantee, no share capital)' | 'Limited Partnership' | 'Limited Liability Partnership' | 'Community Interest Company' | 'Charitable Incorporated Organisation' | 'PRI/LBG/NSC (Private, Limited by guarantee, no share capital, use of 'Limited' exemption)' | 'Overseas Entity' | 'Other company type' | 'Registered Society' | 'Scottish Charitable Incorporated Organisation' | 'Private Unlimited Company' | 'Public Limited Company' | 'Royal Charter Company' | 'Investment Company with Variable Capital' | 'United Kingdom Economic Interest Grouping' | 'Scottish Partnership' | 'Industrial and Provident Society'

Company type: exact match, case-insensitive.

postTownstring

Post town: exact match, case-insensitive. Registered office post town, exact (case-insensitive), e.g. Leeds, Manchester, London

postcodeAreastring

Postcode area: prefix match, case-insensitive. Registered office postcode prefix, e.g. LS (Leeds), SW1, M1. A bare letter also matches longer areas (M matches ME and MK)

countystring

County contains: substring match, case-insensitive.

sicstring

SIC code or activity contains: substring match, case-insensitive. Matches any of the four SIC codes or their descriptions, e.g. 62012 or "software development"

sicCodestring

Primary SIC code starts with: prefix match, case-insensitive. e.g. 62 for computer programming and consultancy, 56 for food and beverage service, 86 for human health

incorporatedSincestring

Incorporated since (YYYY-MM-DD): minimum (inclusive). New companies are the classic lead list

incorporatedBeforestring

Incorporated before (YYYY-MM-DD): maximum (inclusive).

accountCategory'MICRO ENTITY' | 'NO ACCOUNTS FILED' | 'TOTAL EXEMPTION FULL' | 'DORMANT' | 'UNAUDITED ABRIDGED' | 'FULL' | 'SMALL' | 'AUDIT EXEMPTION SUBSIDIARY' | 'GROUP' | 'TOTAL EXEMPTION SMALL' | 'MEDIUM' | 'ACCOUNTS TYPE NOT AVAILABLE' | 'AUDITED ABRIDGED' | 'FILING EXEMPTION SUBSIDIARY'

Accounts category: exact match, case-insensitive.

nameContainsstring

Name contains: substring match, case-insensitive.

limitinteger

Rows to return. Free plans are capped at 25; Pro up to 10,000 per JSON page.

offsetinteger

Rows to skip (paging).

format'json' | 'csv'

json (default) or csv. CSV opens in Excel and is never paged.

Response

Matching rows

datasetstring required
plan'free' | 'pro'
totalinteger required

Rows matching the filters

returnedinteger required
offsetinteger
truncatedboolean required

true when fewer rows than total were returned

ignoredstring[]

Filter keys the dataset does not know

rowsobject[] required
attributionstring required

Keep this with the data

licencestring

Changes

No recorded changes to this operation across all 1 revision of this API.