---
title: "Companies House register (UK)"
method: GET
path: "/v1/datasets/companies-house/query"
tags: ["United Kingdom"]
---

# Companies House register (UK)

`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`

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

## 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'
- `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'
- `postTown` string
- `postcodeArea` string
- `county` string
- `sic` string
- `sicCode` string
- `incorporatedSince` string
- `incorporatedBefore` string
- `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'
- `nameContains` string
- `limit` integer
- `offset` integer
- `format` 'json' | 'csv'

## Response `200`

Matching rows

- QueryResult
  - `dataset` string, required
  - `plan` 'free' | 'pro'
  - `total` integer, required: Rows matching the filters
  - `returned` integer, required
  - `offset` integer
  - `truncated` boolean, required: true when fewer rows than total were returned
  - `ignored` string[]: Filter keys the dataset does not know
  - `columns` object[]
    - `key` string
    - `label` string
  - `rows` object[], required
  - `attribution` string, required: Keep this with the data
  - `licence` string
  - `next_step` object: Present when the plan capped the result: links and wording for getting every row
    - `message` string
    - `buy_export_url` string, uri
    - `signup_url` string, uri
    - `pricing_url` string, uri

---

[API](https://skmtc.dev/datascoop/apis/datascoop-api.md) · [All operations](https://skmtc.dev/datascoop/apis/datascoop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/datascoop/apis/datascoop-api/revisions/102c5cf316da?raw)