Companies House website screenshot

Companies House

Companies House is the UK government executive agency and trading fund responsible for incorporating and dissolving limited companies and registering company information in Great Britain. The Companies House REST API provides a free, open, and standardised way to search and retrieve company registration data, including company profiles, officer appointments, persons of significant control, filing history, charges, and insolvency records. Developers can also access a real-time Streaming API that delivers changes to Companies House data as they happen, enabling applications to stay up-to-date without polling. Authentication is handled via API key using HTTP Basic Auth, and all access is provided free of charge with a generous rate limit.

Companies House publishes 8 APIs on the APIs.io network, including charges API, filingHistory API, insolvency API, and 5 more. Tagged areas include Companies, UK Government, Business Registration, Company Search, and Officers.

The Companies House catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

Companies House’s developer surface includes authentication, documentation, engineering blog, pricing, and 17 more developer resources.

50.8/100 developing ▬ flat Agent 48/100 agent ready Full breakdown ↓
scored 2026-07-27 · rubric v0.5
AccessFreeSelf serve⚡ Free to try
9 APIs
CompaniesUK GovernmentBusiness RegistrationCompany SearchOfficersFiling HistoryInsolvencyChargesPersons of Significant ControlOpen Data

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 50.8/100 · developing
Contract Quality 15.6 / 25
Developer Ergonomics 4.3 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 2.7 / 13
Governance 10.4 / 12
Discoverability 10.0 / 10
Agent readiness — 48/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/companies-house: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 9

Individual APIs this provider publishes, each with its own machine-readable definition.

Companies House Streaming API

The Companies House Streaming API delivers real-time changes to Companies House data via long-running HTTP connections. It streams updates across nine data categories including ...

Companies House personsWithSignificantControl API

Persons with significant control

Scroll for all 9

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Companies House Rate Limits

0 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Companies House Context

0 classes · 60 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Companies House API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 127

Standalone JSON Schema definitions for this provider's data models.

accountInformation

3 properties

JSON SCHEMA

accountingReferenceDate

2 properties

JSON SCHEMA

accountPeriodFrom

2 properties

JSON SCHEMA

accountPeriodTo

2 properties

JSON SCHEMA

accountsInformation

6 properties

JSON SCHEMA

accountsRequired

2 properties

JSON SCHEMA

address

9 properties

JSON SCHEMA

Registered Office Address

6 properties

JSON SCHEMA

advanced_top_hit

0 properties

JSON SCHEMA

advancedCompany

11 properties

JSON SCHEMA

A list of companies

0 properties

JSON SCHEMA

alphabetical_top_hit

0 properties

JSON SCHEMA

Alphabetical company

7 properties

JSON SCHEMA

List of companies

0 properties

JSON SCHEMA

alterationsDesc

3 properties

JSON SCHEMA

annotation

3 properties

JSON SCHEMA

annualReturnInformation

4 properties

JSON SCHEMA

appointedTo

3 properties

JSON SCHEMA

appointmentLinkTypes

1 properties

JSON SCHEMA

appointmentList

10 properties

JSON SCHEMA

associatedFiling

3 properties

JSON SCHEMA

branchCompanyDetails

3 properties

JSON SCHEMA

case

6 properties

JSON SCHEMA

caseDates

2 properties

JSON SCHEMA

charge_links

1 properties

JSON SCHEMA

chargeDetails

21 properties

JSON SCHEMA

chargeList

6 properties

JSON SCHEMA

classificationDesc

2 properties

JSON SCHEMA

CommonSearch

4 properties

JSON SCHEMA

CommonSearchItems

6 properties

JSON SCHEMA

companyDetails

5 properties

JSON SCHEMA

companyExemptions

4 properties

JSON SCHEMA

companyInsolvency

3 properties

JSON SCHEMA

companyProfile

32 properties

JSON SCHEMA

companyRegister

5 properties

JSON SCHEMA

CompanySearch

2 properties

JSON SCHEMA

CompanySearchItems

8 properties

JSON SCHEMA

companyUKEstablishments

4 properties

JSON SCHEMA

confirmationOfStatementInformation

4 properties

JSON SCHEMA

contactDetails

1 properties

JSON SCHEMA

corporateAnnotation

3 properties

JSON SCHEMA

corporateDisqualification

9 properties

JSON SCHEMA

corporateIdent

5 properties

JSON SCHEMA

dateOfBirth

2 properties

JSON SCHEMA

disqualification

11 properties

JSON SCHEMA

DisqualifiedOfficerAddress

7 properties

JSON SCHEMA

DisqualifiedOfficerSearch

2 properties

JSON SCHEMA

DisqualifiedOfficerSearchItems

4 properties

JSON SCHEMA

Registered Office Address

4 properties

JSON SCHEMA

dissolved_top_hit

0 properties

JSON SCHEMA

Dissolved company

10 properties

JSON SCHEMA

List of dissolved companies

0 properties

JSON SCHEMA

exemptionItem

2 properties

JSON SCHEMA

exemptions

5 properties

JSON SCHEMA

fileWithin

1 properties

JSON SCHEMA

filingHistoryItem

13 properties

JSON SCHEMA

filingHistoryItemLinks

2 properties

JSON SCHEMA

filingHistoryList

7 properties

JSON SCHEMA

foreignCompanyDetails

8 properties

JSON SCHEMA

formerNames

2 properties

JSON SCHEMA

insolvency_case_links

1 properties

JSON SCHEMA

insolvency_cases

2 properties

JSON SCHEMA

itemLinkTypes

2 properties

JSON SCHEMA

last_variation

3 properties

JSON SCHEMA

lastAccounts

4 properties

JSON SCHEMA

links

1 properties

JSON SCHEMA

linksDirectorsRegister

1 properties

JSON SCHEMA

linksItems

1 properties

JSON SCHEMA

linksListLLPMembers

1 properties

JSON SCHEMA

linksListLLPUsualResidentialAddress

1 properties

JSON SCHEMA

linksListMembers

1 properties

JSON SCHEMA

linksListUsualResidentialAddress

1 properties

JSON SCHEMA

LinksModel

1 properties

JSON SCHEMA

linksSecretaryRegister

1 properties

JSON SCHEMA

linksType

11 properties

JSON SCHEMA

linkTypes

1 properties

JSON SCHEMA

MatchesModel

3 properties

JSON SCHEMA

nameElements

5 properties

JSON SCHEMA

naturalDisqualification

13 properties

JSON SCHEMA

nextAccounts

4 properties

JSON SCHEMA

notificationList

11 properties

JSON SCHEMA

OfficerAddress

9 properties

JSON SCHEMA

officerAppointmentSummary

19 properties

JSON SCHEMA

OfficerDateOfBirth

2 properties

JSON SCHEMA

officerLinkTypes

1 properties

JSON SCHEMA

officerList

9 properties

JSON SCHEMA

OfficerSearch

2 properties

JSON SCHEMA

OfficerSearchItems

5 properties

JSON SCHEMA

officerSummary

20 properties

JSON SCHEMA

originatingRegistry

2 properties

JSON SCHEMA

particularDesc

7 properties

JSON SCHEMA

permission_to_act

4 properties

JSON SCHEMA

persons_entitled

1 properties

JSON SCHEMA

PersonswithsignificantcontrolAddress

9 properties

JSON SCHEMA

PersonswithsignificantcontrolSearch

2 properties

JSON SCHEMA

practitionerAddress

6 properties

JSON SCHEMA

practitioners

5 properties

JSON SCHEMA

Previous company name

4 properties

JSON SCHEMA

previousCompanyNames

3 properties

JSON SCHEMA

principalOfficeAddress

9 properties

JSON SCHEMA

pscExemptAsSharesAdmittedOnMarketItem

2 properties

JSON SCHEMA

reason

4 properties

JSON SCHEMA

registeredItems

3 properties

JSON SCHEMA

registeredOfficeAddress

9 properties

JSON SCHEMA

registerListDirectors

3 properties

JSON SCHEMA

registerListLLPMembers

3 properties

JSON SCHEMA

registerListMembers

3 properties

JSON SCHEMA

registerListSecretaries

3 properties

JSON SCHEMA

registerListUsualResidentialAddress

3 properties

JSON SCHEMA

registers

7 properties

JSON SCHEMA

resolution

6 properties

JSON SCHEMA

Search

2 properties

JSON SCHEMA

SearchItems

3 properties

JSON SCHEMA

securedDetailsDesc

2 properties

JSON SCHEMA

self_links

1 properties

JSON SCHEMA

serviceAddress

8 properties

JSON SCHEMA

transaction_links

2 properties

JSON SCHEMA

transactions

4 properties

JSON SCHEMA

Scroll for all 127

Examples 1

Example request and response payloads for these APIs.

Companies House Examples

28 fields

EXAMPLE

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Companies House Authentication

apiKey · 1 scheme

SECURITY

Companies House Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Companies House Vulnerability Disclosure

Hackerone · security.txt · contact published

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Companies House Agentic Access

28 operations

28 operations · 0 acting

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

Build 1

SDKs, sample code, and the tooling you integrate with

Access & Security 4

Authentication, authorization, and security posture

Operate 3

Status, limits, changes, and where to get help

Commercial 3

Pricing, plans, and the legal terms of use

Company 4

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: https://raw.githubusercontent.com/api-evangelist/companies-house/refs/heads/main/apis.yml
name: Companies House
description: 'Companies House is the UK government executive agency and trading fund responsible for incorporating and dissolving
  limited companies and registering company information in Great Britain. The Companies House REST API provides a free, open,
  and standardised way to search and retrieve company registration data, including company profiles, officer appointments,
  persons of significant control, filing history, charges, and insolvency records. Developers can also access a real-time
  Streaming API that delivers changes to Companies House data as they happen, enabling applications to stay up-to-date without
  polling. Authentication is handled via API key using HTTP Basic Auth, and all access is provided free of charge with a generous
  rate limit.

  '
type: Index
accessModel:
  pricing: free
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Free · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/companies-house.png
url: https://raw.githubusercontent.com/api-evangelist/companies-house/refs/heads/main/apis.yml
created: '2026-06-12'
modified: '2026-06-12'
specificationVersion: '0.19'
tags:
- Companies
- UK Government
- Business Registration
- Company Search
- Officers
- Filing History
- Insolvency
- Charges
- Persons of Significant Control
- Open Data
apis:
- name: Companies House Streaming API
  description: 'The Companies House Streaming API delivers real-time changes to Companies House data via long-running HTTP
    connections. It streams updates across nine data categories including company information, filing history, insolvency,
    charges, officers, persons with significant control, disqualified officers, exemptions, and PSC statements. Each account
    is limited to two concurrent streaming connections and requires an API key for authentication.

    '
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://developer-specs.company-information.service.gov.uk/streaming-api/guides/overview
  baseURL: https://stream.companieshouse.gov.uk
  tags:
  - Streaming
  - Real-Time
  - Companies
  - Officers
  - Filing History
  properties:
  - type: Documentation
    url: https://developer-specs.company-information.service.gov.uk/streaming-api/guides/overview
  contact:
  - FN: Companies House Developer Forum
    url: https://forum.companieshouse.gov.uk/
- aid: companies-house:companies-house-charges-api
  name: Companies House charges API
  description: Charges
  humanURL: https://developer.company-information.service.gov.uk/overview
  baseURL: https://api.company-information.service.gov.uk
  tags:
  - charges
  properties:
  - type: OpenAPI
    url: openapi/companies-house-charges-api-openapi.yml
  - type: Documentation
    url: https://developer-specs.company-information.service.gov.uk/companies-house-public-data-api/reference
  - type: JSONSchema
    url: json-schema/
  - type: Examples
    url: examples/companies-house-examples.json
- aid: companies-house:companies-house-filinghistory-api
  name: Companies House filingHistory API
  description: Filing history
  humanURL: https://developer.company-information.service.gov.uk/overview
  baseURL: https://api.company-information.service.gov.uk
  tags:
  - filingHistory
  properties:
  - type: OpenAPI
    url: openapi/companies-house-filinghistory-api-openapi.yml
  - type: Documentation
    url: https://developer-specs.company-information.service.gov.uk/companies-house-public-data-api/reference
  - type: JSONSchema
    url: json-schema/
  - type: Examples
    url: examples/companies-house-examples.json
- aid: companies-house:companies-house-insolvency-api
  name: Companies House insolvency API
  description: Insolvency
  humanURL: https://developer.company-information.service.gov.uk/overview
  baseURL: https://api.company-information.service.gov.uk
  tags:
  - insolvency
  properties:
  - type: OpenAPI
    url: openapi/companies-house-insolvency-api-openapi.yml
  - type: Documentation
    url: https://developer-specs.company-information.service.gov.uk/companies-house-public-data-api/reference
  - type: JSONSchema
    url: json-schema/
  - type: Examples
    url: examples/companies-house-examples.json
- aid: companies-house:companies-house-officerdisqualifications-api
  name: Companies House officerDisqualifications API
  description: Officer disqualifications
  humanURL: https://developer.company-information.service.gov.uk/overview
  baseURL: https://api.company-information.service.gov.uk
  tags:
  - officerDisqualifications
  properties:
  - type: OpenAPI
    url: openapi/companies-house-officerdisqualifications-api-openapi.yml
  - type: Documentation
    url: https://developer-specs.company-information.service.gov.uk/companies-house-public-data-api/reference
  - type: JSONSchema
    url: json-schema/
  - type: Examples
    url: examples/companies-house-examples.json
- aid: companies-house:companies-house-officers-api
  name: Companies House officers API
  description: Officers
  humanURL: https://developer.company-information.service.gov.uk/overview
  baseURL: https://api.company-information.service.gov.uk
  tags:
  - officers
  properties:
  - type: OpenAPI
    url: openapi/companies-house-officers-api-openapi.yml
  - type: Documentation
    url: https://developer-specs.company-information.service.gov.uk/companies-house-public-data-api/reference
  - type: JSONSchema
    url: json-schema/
  - type: Examples
    url: examples/companies-house-examples.json
- aid: companies-house:companies-house-personswithsignificantcontrol-api
  name: Companies House personsWithSignificantControl API
  description: Persons with significant control
  humanURL: https://developer.company-information.service.gov.uk/overview
  baseURL: https://api.company-information.service.gov.uk
  tags:
  - personsWithSignificantControl
  properties:
  - type: OpenAPI
    url: openapi/companies-house-personswithsignificantcontrol-api-openapi.yml
  - type: Documentation
    url: https://developer-specs.company-information.service.gov.uk/companies-house-public-data-api/reference
  - type: JSONSchema
    url: json-schema/
  - type: Examples
    url: examples/companies-house-examples.json
- aid: companies-house:companies-house-registeredofficeaddress-api
  name: Companies House registeredOfficeAddress API
  description: Registered office address
  humanURL: https://developer.company-information.service.gov.uk/overview
  baseURL: https://api.company-information.service.gov.uk
  tags:
  - registeredOfficeAddress
  properties:
  - type: OpenAPI
    url: openapi/companies-house-registeredofficeaddress-api-openapi.yml
  - type: Documentation
    url: https://developer-specs.company-information.service.gov.uk/companies-house-public-data-api/reference
  - type: JSONSchema
    url: json-schema/
  - type: Examples
    url: examples/companies-house-examples.json
- aid: companies-house:companies-house-search-api
  name: Companies House search API
  description: Search
  humanURL: https://developer.company-information.service.gov.uk/overview
  baseURL: https://api.company-information.service.gov.uk
  tags:
  - search
  properties:
  - type: OpenAPI
    url: openapi/companies-house-search-api-openapi.yml
  - type: Documentation
    url: https://developer-specs.company-information.service.gov.uk/companies-house-public-data-api/reference
  - type: JSONSchema
    url: json-schema/
  - type: Examples
    url: examples/companies-house-examples.json
common:
- type: AgenticAccess
  url: agentic-access/companies-house-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/companies-house-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/companies-house-domain-security.yml
- type: Authentication
  url: authentication/companies-house-authentication.yml
- type: Website
  url: https://www.gov.uk/government/organisations/companies-house
- type: Documentation
  url: https://developer.company-information.service.gov.uk/overview
- type: GitHubOrg
  url: https://github.com/companieshouse
- type: LinkedIn
  url: https://www.linkedin.com/company/companies-house
- type: Blog
  url: https://companieshouse.blog.gov.uk
- type: Pricing
  url: https://developer.company-information.service.gov.uk/overview
- type: StatusPage
  url: https://forum.companieshouse.gov.uk/c/api-changes/7
- type: X
  url: https://x.com/CompaniesHouse
- type: Forums
  url: https://forum.companieshouse.gov.uk
- type: Authentication
  url: https://developer-specs.company-information.service.gov.uk/guides/authorisation
- type: Plans
  url: plans/companies-house-plans-pricing.yml
- type: RateLimits
  url: rate-limits/companies-house-rate-limits.yml
- type: FinOps
  url: finops/companies-house-finops.yml
- type: Vocabulary
  url: vocabulary/companies-house-vocabulary.yml
- type: JSONLDContext
  url: json-ld/companies-house-context.jsonld
- type: BlogRSS
  url: https://companieshouse.blog.gov.uk/feed/
- type: BlogIndex
  url: blogs/blogs.json
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com