Companies House

CompaniesGB

api.company-information.service.gov.uk

The UK company register: company profiles, officers, filing history, charges, beneficial ownership and disqualified directors.

Try it now Read the docs

Capabilities (22)

GET /v1/data/companieshouse/advanced-search1 credit

Filter the register by name fragment, status, type, SIC code, incorporation date range or registered address locality.

company_name_includes?company_name_excludes?company_status?company_subtype?company_type?dissolved_from?dissolved_to?incorporated_from?incorporated_to?location?sic_codes?size?start_index?

GET /v1/data/companieshouse/alphabetical-search1 credit

Companies listed in register order from a starting name, rather than by relevance.

qsize?search_above?search_below?

GET /v1/data/companieshouse/appointment1 credit

One officer's appointment at one company: role, dates, address, nationality and occupation.

companyNumberappointmentId

GET /v1/data/companieshouse/charge1 credit

One registered charge in full: the instrument, the persons entitled, the property charged and its satisfaction status.

companyNumberchargeId

GET /v1/data/companieshouse/charges1 credit

Mortgages and charges registered against a company, with their status, creation date and the persons entitled.

companyNumberitems_per_page?start_index?

GET /v1/data/companieshouse/company1 credit

One company in full: status, type, incorporation and accounts dates, SIC codes, registered office and previous names.

companyNumber

GET /v1/data/companieshouse/company-search1 credit

Search live and dissolved companies by name or number, with the status, type and incorporation date of each match.

qitems_per_page?start_index?restrictions?

GET /v1/data/companieshouse/disqualified-corporate1 credit

One disqualified corporate officer: the disqualification reason, the period, and the companies involved.

officerId

GET /v1/data/companieshouse/disqualified-search1 credit

Search directors disqualified from acting, by name.

qitems_per_page?start_index?

GET /v1/data/companieshouse/dissolved-search1 credit

Search companies removed from the register, with their dissolution date and previous names.

qsize?start_index?

GET /v1/data/companieshouse/exemptions1 credit

Exemptions a company holds from PSC or accounts requirements, with the period each applies to.

companyNumber

GET /v1/data/companieshouse/filing1 credit

One filed document: its type, date, description and the pages of the document metadata.

companyNumbertransactionId

GET /v1/data/companieshouse/filing-history1 credit

Every document filed at Companies House for a company: accounts, confirmation statements, officer changes and charges, each with its date and type.

companyNumberitems_per_page?start_index?category?

GET /v1/data/companieshouse/insolvency1 credit

Insolvency cases against a company: type, dates and the practitioners appointed.

companyNumber

GET /v1/data/companieshouse/officer-appointments1 credit

Every company an officer is or was appointed to, with the role and dates at each.

officerIditems_per_page?start_index?

GET /v1/data/companieshouse/officers1 credit

Current and resigned directors and secretaries, with appointment and resignation dates, nationality, occupation and correspondence address.

companyNumberitems_per_page?start_index?register_type?order_by?

GET /v1/data/companieshouse/officer-search1 credit

Search people appointed as company officers by name.

qitems_per_page?start_index?

GET /v1/data/companieshouse/psc1 credit

The beneficial owners of a company: individuals, corporate entities and legal persons, with the nature of their control.

companyNumberitems_per_page?start_index?register_view?

GET /v1/data/companieshouse/psc-corporate1 credit

One corporate beneficial owner: its name, registered address, governing law and the nature of its control.

companyNumberpscId

GET /v1/data/companieshouse/registered-office1 credit

The company's registered office address as currently recorded.

companyNumber

GET /v1/data/companieshouse/search-all1 credit

One search across companies, officers and disqualified officers, each match tagged with its kind.

qitems_per_page?start_index?

GET /v1/data/companieshouse/uk-establishments1 credit

The UK establishments of an overseas company.

companyNumber

Response example

The shape of data from companieshouse/advanced-search (Advanced company search). A sample, not live data.

Example truncated, full shape in JSON from the API.

JSON

{
  "etag": "c8531438000342cdf7424d4d9a8b03e6ac965056",
  "top_hit": {
    "company_name": "TOP SECURITY FENCING (N.I.) LIMITED",
    "company_number": "NI019468",
    "company_status": "dissolved",
    "company_type": "ltd",
    "kind": "search-results#company",
    "links": {
      "company_profile": "/company/NI019468"
    },
    "date_of_cessation": "2016-02-09",
    "date_of_creation": "1986-05-13",
    "registered_office_address": {
      "address_line_1": "64 New Road",
      "address_line_2": "Silverbridge",
      "locality": "Newry",
      "postal_code": "BT35 9LN",
      "region": "Co.Down"
    },
    "sic_codes": [
      "25720"
    ]
  },
  "items": [
    {
      "company_name": "TOP SECURITY FENCING (N.I.) LIMITED",
      "company_number": "NI019468",
      "company_status": "dissolved",
      "company_type": "ltd",
      "kind": "search-results#company",
      "links": {
        "company_profile": "/company/NI019468"
      },
      "date_of_cessation": "2016-02-09",
      "date_of_creation": "1986-05-13",
      "registered_office_address": {
        "address_line_1": "64 New Road",
        "address_line_2": "Silverbridge",
        "locality": "Newry",
        "postal_code": "BT35 9LN",
        "region": "Co.Down"
      },
      "sic_codes": [
        "25720"
      ]
    },
    {
      "company_name": "YOUTH FASHIONS LIMITED",
      "company_number": "NI016353",
      "company_status": "dissolved",
      "company_type": "ltd",
      "kind": "search-results#company",
      "links": {
        "company_profile": "/company/NI016353"
      },
      "date_of_cessation": "2021-12-24",
      "date_of_creation": "1983-01-06",
      "registered_office_address": {
        "address_line_1": "C/O Grant Thornton (Ni) Llp",
        "address_line_2": "12-15 Donegall Square West",
        "locality": "Belfast",
        "postal_code": "BT1 6JH"
      },
      "sic_codes": [
        "47710"
      ]
    },
    {
      "company_name": "PARAGON TILES LIMITED",
      "company_number": "NI017448",
      "company_status": "dissolved",
      "company_type": "ltd",
      "kind": "search-results#company",
      "links": {
        "company_profile": "/company/NI017448"
      },
      "date_of_cessation": "2017-08-02",
      "date_of_creation": "1984-04-30",
      "registered_office_address": {
        "address_line_1": "Centrepoint",
        "address_line_2": "24 Ormeau Avenue",
        "locality": "Belfast",
        "postal_code": "BT2 8HS"
      },
      "sic_codes": [
        "46760"
      ]
    },
    {
      "company_name": "CORDINER'S WINDOWS LIMITED",
      "company_number": "NI018012",
      "company_status": "dissolved",
      "company_type": "ltd",
      "kind": "search-results#company",
      "links": {
        "company_profile": "/company/NI018012"
      },
      "date_of_cessation": "2017-03-06",
      "date_of_creation": "1984-12-05",
      "registered_office_address": {
        "address_line_1": "C/O Kpmg  Stokes House",
        "address_line_2": "College Square East",
        "locality": "Belfast",
        "postal_code": "BT1 6DH"
      }
    },
    {
      "company_name": "NOONAN CLEANING LIMITED",
      "company_number": "NI019004",
      "company_status": "dissolved",
      "company_type": "ltd",
      "kind": "search-results#company",
      "links": {
        "company_profile": "/company/NI019004"
      },
      "date_of_cessation": "2014-10-03",
      "date_of_creation": "1985-12-10",
      "registered_office_address": {
        "address_line_1": "Security House",
        "address_line_2": "Lissue Industrial Estate East",
        "locality": "Lisburn",
        "postal_code": "BT28 2SN",
        "region": "Co Antrim",
        "country": "Northern Ireland"
      },
      "sic_codes": [
        "81222"
      ]
    },
    {
      "company_name": "BAHIA BLANCA CLUB B LIMITED",
      "company_number": "NI018484",
      "company_status": "dissolved",
      "company_type": "private-limited-guarant-nsc",
      "kind": "search-resu

Ask with this source

A prompt for your agent that names this source and how to call it through the crw MCP.

Advanced company search
Use Companies House (companieshouse) from fastCRW Pergamon, capability "Advanced company search" (advanced-search). You need every company matching structured criteria rather than one name, e.g. all active companies in a SIC code. Example options: company_name_includes=tesco, company_status=active, company_type=plc. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "companieshouse" and capability "advanced-search". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Alphabetical company search
Use Companies House (companieshouse) from fastCRW Pergamon, capability "Alphabetical company search" (alphabetical-search). You are walking the register in name order rather than searching for one company. Example options: q=tesco, size=20. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "companieshouse" and capability "alphabetical-search". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Officer appointment detail
Use Companies House (companieshouse) from fastCRW Pergamon, capability "Officer appointment detail" (appointment). You have an appointment id from an officers list and want that single appointment. Example options: companyNumber=00445790, appointmentId=lnfNdAqKHBZCL2akA7SXLkkA8KI. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "companieshouse" and capability "appointment". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Charge detail
Use Companies House (companieshouse) from fastCRW Pergamon, capability "Charge detail" (charge). You have a charge id from the charges list and need its particulars. Example options: companyNumber=00445790, chargeId=5QU1lSudRI2jTIfUv_AOVxfLxVE. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "companieshouse" and capability "charge". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

Licence

Crown copyright, published under the Open Government Licence v3.0. Companies House states the public register data may be used and re-used free of charge, including commercially, provided the source is acknowledged.

https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/

Attribution

Display this wherever you show the data. It arrives on every response as provenance.attribution_text.

Contains public sector information licensed under the Open Government Licence v3.0 (Companies House)

Cache: up to 3600s

Read the docs Back to the catalog

Companies House

Capabilities (22)

Response example

Ask with this source

Advanced company search

Alphabetical company search

Officer appointment detail

Charge detail

Licence

Attribution