# Companies House API

> Companies House returns UK company records, officers, owners and filings as a workflow and API.

Companies House searches the UK public register by company name and returns matching company details in result order. Get company profile returns public registration details for a company identified by name, number or Companies House link. List directors, List owners and List filing history return officers, owners and recent filings for a company identified by name, number or link.

- Page: https://fous.com/tools/companies-house
- Handle: `@companies-house`
- Category: [Government](https://fous.com/tools/category/government)
- Source website: https://find-and-update.company-information.service.gov.uk
- Last verified: Sep 28, 2026

## Methods

### Get company profile

Operation `get_company_profile`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get a UK company’s public registration details by name, company number or Companies House link. Names prefer an active exact match.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `company` | string | yes | `"00229606"` | Company name, company number or Companies House page link, for example Tesco PLC. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "company"
  ],
  "properties": {
    "company": {
      "type": "string",
      "description": "Company name, company number or Companies House page link, for example Tesco PLC.",
      "examples": [
        "00229606",
        "Tesco PLC",
        "https://find-and-update.company-information.service.gov.uk/company/00000006"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "company": "00229606"
    },
    {
      "company": "Tesco PLC"
    },
    {
      "company": "https://find-and-update.company-information.service.gov.uk/company/00000006"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `status` | string or null | `"Liquidation"` |  |
| `page_link` | string | `"https://find-and-update.company-information.service.gov.uk/company/00229606"` |  |
| `sic_codes` | array |  |  |
| `company_name` | string | `"SHB REALISATIONS LIMITED"` |  |
| `company_type` | string or null | `"Private limited Company"` |  |
| `company_number` | string | `"00229606"` |  |
| `dissolved_date` | string or null | `"2018-07-10"` |  |
| `previous_names` | array |  |  |
| `previous_names[].name` | string | `"BHS LIMITED"` |  |
| `previous_names[].to_date` | string or null | `"2016-09-28"` |  |
| `previous_names[].from_date` | string or null | `"1988-12-01"` |  |
| `accounts_overdue` | string | `"yes"` |  |
| `incorporation_date` | string or null | `"1928-04-12"` |  |
| `nature_of_business` | array |  |  |
| `next_accounts_due_date` | string or null | `"2016-11-30"` |  |
| `registered_office_address` | string or null | `"2nd Floor 110 Cannon Street, London, EC4N 6EU"` |  |
| `last_accounts_made_up_date` | string or null | `"2014-08-30"` |  |
| `confirmation_statement_overdue` | string | `"yes"` |  |
| `next_confirmation_statement_due_date` | string or null | `"2017-06-15"` |  |

**Example input**

```json
{
  "company": "00229606"
}
```

**Example output**

```json
{
  "status": "Liquidation",
  "page_link": "https://find-and-update.company-information.service.gov.uk/company/00229606",
  "sic_codes": [
    "47190"
  ],
  "company_name": "SHB REALISATIONS LIMITED",
  "company_type": "Private limited Company",
  "company_number": "00229606",
  "dissolved_date": null,
  "previous_names": [
    {
      "name": "BHS LIMITED",
      "to_date": "2016-09-28",
      "from_date": "1988-12-01"
    },
    {
      "name": "BRITISH HOME STORES PLC",
      "to_date": "1988-12-01",
      "from_date": "1928-04-12"
    }
  ],
  "accounts_overdue": "yes",
  "incorporation_date": "1928-04-12",
  "nature_of_business": [
    "Other retail sale in non-specialised stores"
  ],
  "next_accounts_due_date": "2016-11-30",
  "registered_office_address": "2nd Floor 110 Cannon Street, London, EC4N 6EU",
  "last_accounts_made_up_date": "2014-08-30",
  "confirmation_statement_overdue": "yes",
  "next_confirmation_statement_due_date": "2017-06-15"
}
```

### List directors

Operation `list_directors`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List a UK company’s current and resigned directors, secretaries and other registered officers by company name, number or Companies House link. Missing public details are null; an “appointed before” date is not an exact appointment date.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `company` | string | yes | `"Tesco PLC"` | Company name, number, or Companies House company link, for example Tesco PLC. |
| `max_results` | integer | no | `50` | Most officers to return, for example 50. |
| `include_resigned` | string | no | `"yes"` | Include former officers as well as current officers, for example yes. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "company"
  ],
  "properties": {
    "company": {
      "type": "string",
      "description": "Company name, number, or Companies House company link, for example Tesco PLC.",
      "examples": [
        "Tesco PLC",
        "00445790",
        "https://find-and-update.company-information.service.gov.uk/company/OC300001/officers"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Most officers to return, for example 50.",
      "x-fous-developer": true,
      "examples": [
        50,
        20,
        5
      ]
    },
    "include_resigned": {
      "enum": [
        "yes",
        "no"
      ],
      "type": "string",
      "default": "yes",
      "description": "Include former officers as well as current officers, for example yes.",
      "examples": [
        "yes",
        "no"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "company": "Tesco PLC",
      "max_results": 50,
      "include_resigned": "yes"
    },
    {
      "company": "00445790",
      "max_results": 20,
      "include_resigned": "no"
    },
    {
      "company": "https://find-and-update.company-information.service.gov.uk/company/OC300001/officers",
      "max_results": 5
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `officers` | array |  | Officers, current first, followed by resigned. |
| `officers[].role` | string | `"Secretary"` | Officer role in words. |
| `officers[].full_name` | string | `"TAYLOR, Christopher Jon"` | Officer’s full name as shown on the register. |
| `officers[].occupation` | string or null |  | Occupation, when shown. |
| `officers[].nationality` | string or null | `"British"` | Nationality, when shown. |
| `officers[].resigned_date` | string or null |  | Resignation date, or null for a current officer. |
| `officers[].appointed_date` | string or null | `"2025-04-14"` | Exact appointment date, or null when only an appointed-before date is shown. |
| `officers[].birth_month_year` | string or null | `"September 1974"` | Month and year of birth as shown. |
| `officers[].appointments_link` | string or null | `"https://find-and-update.company-information.service.gov.uk/officers/uJ_F_UGCbPiYELlJ_fHc-J_goqo/appointments"` | Link to the officer’s appointments page. |
| `officers[].country_of_residence` | string or null | `"United Kingdom"` | Place or country of residence, when shown. |
| `officers[].correspondence_address` | string or null | `"Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA"` | Registered correspondence address. |
| `company_link` | string | `"https://find-and-update.company-information.service.gov.uk/company/00445790"` | Company page link. |
| `company_name` | string | `"TESCO PLC"` | Registered company name. |
| `company_number` | string | `"00445790"` | Registered company number. |

**Example input**

```json
{
  "company": "Tesco PLC",
  "max_results": 50,
  "include_resigned": "yes"
}
```

**Example output**

```json
{
  "officers": [
    {
      "role": "Secretary",
      "full_name": "TAYLOR, Christopher Jon",
      "occupation": null,
      "nationality": null,
      "resigned_date": null,
      "appointed_date": "2025-04-14",
      "birth_month_year": null,
      "appointments_link": "https://find-and-update.company-information.service.gov.uk/officers/uJ_F_UGCbPiYELlJ_fHc-J_goqo/appointments",
      "country_of_residence": null,
      "correspondence_address": "Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA"
    },
    {
      "role": "Director",
      "full_name": "BETHELL, Melissa",
      "occupation": null,
      "nationality": "British",
      "resigned_date": null,
      "appointed_date": "2018-09-24",
      "birth_month_year": "September 1974",
      "appointments_link": "https://find-and-update.company-information.service.gov.uk/officers/aqrS_F-2zIvSaMNtl1opqDV4-w0/appointments",
      "country_of_residence": "United Kingdom",
      "correspondence_address": "Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA"
    },
    {
      "role": "Director",
      "full_name": "BODSON, Bertrand Jean Francois",
      "occupation": null,
      "nationality": "Belgian",
      "resigned_date": null,
      "appointed_date": "2021-06-01",
      "birth_month_year": "June 1975",
      "appointments_link": "https://find-and-update.company-information.service.gov.uk/officers/i4-DBrP10YuSc6pscv-b3MCQPQ8/appointments",
      "country_of_residence": "England",
      "correspondence_address": "Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA"
    }
  ],
  "company_link": "https://find-and-update.company-information.service.gov.uk/company/00445790",
  "company_name": "TESCO PLC",
  "company_number": "00445790"
}
```

### List filing history

Operation `list_filing_history`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List a UK company’s recent filings with their dates, descriptions, page counts and PDF links. Find the company by name, number or Companies House link; address filings are identified from the filing descriptions and form codes.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `company` | string | yes | `"Tesco PLC"` | UK company name, company number or Companies House company link, for example Tesco PLC. |
| `max_results` | integer | no | `3` | Maximum filings to return, for example 20 (up to 100). |
| `filing_category` | string | no | `"accounts"` | Choose which filings to list, for example accounts. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "company"
  ],
  "properties": {
    "company": {
      "type": "string",
      "description": "UK company name, company number or Companies House company link, for example Tesco PLC.",
      "examples": [
        "Tesco PLC",
        "00445790",
        "https://find-and-update.company-information.service.gov.uk/company/00445790"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum filings to return, for example 20 (up to 100).",
      "x-fous-developer": true,
      "examples": [
        3,
        30,
        2
      ]
    },
    "filing_category": {
      "enum": [
        "all",
        "accounts",
        "confirmation_statements",
        "officers",
        "address",
        "capital",
        "charges",
        "incorporation"
      ],
      "type": "string",
      "default": "all",
      "description": "Choose which filings to list, for example accounts.",
      "examples": [
        "accounts",
        "officers",
        "all"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "company": "Tesco PLC",
      "max_results": 3,
      "filing_category": "accounts"
    },
    {
      "company": "00445790",
      "max_results": 30,
      "filing_category": "officers"
    },
    {
      "company": "https://find-and-update.company-information.service.gov.uk/company/00445790",
      "max_results": 30,
      "filing_category": "all"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `filings` | array |  |  |
| `filings[].form_code` | string or null | `"AA"` |  |
| `filings[].page_link` | string | `"https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzNDMwNDQ5M2FkaXF6a2N4/doc` |  |
| `filings[].description` | string | `"Group of companies' accounts made up to 28 February 2026"` |  |
| `filings[].filing_date` | string | `"2026-07-25"` |  |
| `filings[].filing_type` | string | `"Annual accounts"` |  |
| `filings[].transaction_id` | string or null | `"MzUzNDMwNDQ5M2FkaXF6a2N4"` |  |
| `filings[].number_of_pages` | integer or null | `236` |  |
| `filings[].document_pdf_link` | string or null | `"https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzNDMwNDQ5M2FkaXF6a2N4/doc` |  |
| `company_name` | string | `"TESCO PLC"` |  |
| `company_number` | string | `"00445790"` |  |

**Example input**

```json
{
  "company": "Tesco PLC",
  "max_results": 3,
  "filing_category": "accounts"
}
```

**Example output**

```json
{
  "filings": [
    {
      "form_code": "AA",
      "page_link": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzNDMwNDQ5M2FkaXF6a2N4/document",
      "description": "Group of companies' accounts made up to 28 February 2026",
      "filing_date": "2026-07-25",
      "filing_type": "Annual accounts",
      "transaction_id": "MzUzNDMwNDQ5M2FkaXF6a2N4",
      "number_of_pages": 236,
      "document_pdf_link": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzNDMwNDQ5M2FkaXF6a2N4/document?format=pdf&download=0"
    },
    {
      "form_code": "AA",
      "page_link": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzQ3MzY5NzQ1OWFkaXF6a2N4/document",
      "description": "Group of companies' accounts made up to 26 February 2025",
      "filing_date": "2025-07-15",
      "filing_type": "Annual accounts",
      "transaction_id": "MzQ3MzY5NzQ1OWFkaXF6a2N4",
      "number_of_pages": 250,
      "document_pdf_link": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzQ3MzY5NzQ1OWFkaXF6a2N4/document?format=pdf&download=0"
    },
    {
      "form_code": "AA",
      "page_link": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzQyNjcxOTc1NGFkaXF6a2N4/document",
      "description": "Group of companies' accounts made up to 24 February 2024",
      "filing_date": "2024-07-02",
      "filing_type": "Annual accounts",
      "transaction_id": "MzQyNjcxOTc1NGFkaXF6a2N4",
      "number_of_pages": 239,
      "document_pdf_link": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzQyNjcxOTc1NGFkaXF6a2N4/document?format=pdf&download=0"
    }
  ],
  "company_name": "TESCO PLC",
  "company_number": "00445790"
}
```

### List owners

Operation `list_owners`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List a UK company’s people with significant control and any register statement. Ceased entries are optional; details reflect the public register.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `company` | string | yes | `"14785367"` | Company name, company number, or Companies House company link, for example Monzo Bank. |
| `include_ceased` | boolean | no | `true` | Include ceased owners and withdrawn statements, for example false. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "company"
  ],
  "properties": {
    "company": {
      "type": "string",
      "description": "Company name, company number, or Companies House company link, for example Monzo Bank.",
      "examples": [
        "14785367",
        "Monzo Bank",
        "https://find-and-update.company-information.service.gov.uk/company/09446231"
      ]
    },
    "include_ceased": {
      "type": "boolean",
      "default": false,
      "description": "Include ceased owners and withdrawn statements, for example false.",
      "examples": [
        true
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "company": "14785367",
      "include_ceased": true
    },
    {
      "company": "Monzo Bank"
    },
    {
      "company": "https://find-and-update.company-information.service.gov.uk/company/09446231",
      "include_ceased": true
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `owners` | array |  |  |
| `owners[].kind` | string | `"individual"` |  |
| `owners[].name` | string | `"Mr Gary Andrew Hoffman"` |  |
| `owners[].country` | string or null | `"England And Wales"` |  |
| `owners[].page_link` | string | `"https://find-and-update.company-information.service.gov.uk/company/14785367/persons-with-significant-control#psc-name-2` |  |
| `owners[].ceased_date` | string or null | `"2023-09-12"` |  |
| `owners[].nationality` | string or null | `"British"` |  |
| `owners[].notified_date` | string or null | `"2023-04-06"` |  |
| `owners[].birth_month_year` | string or null | `"October 1960"` |  |
| `owners[].nature_of_control` | array |  |  |
| `owners[].registered_address` | string or null | `"Broadwalk House, 5, Appold Street, London, United Kingdom, EC2A 2AG"` |  |
| `owners[].country_of_residence` | string or null | `"United Kingdom"` |  |
| `company_link` | string | `"https://find-and-update.company-information.service.gov.uk/company/14785367"` |  |
| `company_name` | string | `"MONZO BANK HOLDING GROUP LIMITED"` |  |
| `company_number` | string | `"14785367"` |  |
| `register_statement` | string or null | `"The company knows or has reasonable cause to believe that there is no registrable person or registrable relevant legal ` |  |

**Example input**

```json
{
  "company": "14785367",
  "include_ceased": true
}
```

**Example output**

```json
{
  "owners": [
    {
      "kind": "individual",
      "name": "Mr Gary Andrew Hoffman",
      "country": null,
      "page_link": "https://find-and-update.company-information.service.gov.uk/company/14785367/persons-with-significant-control#psc-name-2",
      "ceased_date": "2023-09-12",
      "nationality": "British",
      "notified_date": "2023-04-06",
      "birth_month_year": "October 1960",
      "nature_of_control": [
        "Owns 75% or more of shares",
        "Controls 75% or more of voting rights",
        "Right to appoint or remove directors"
      ],
      "registered_address": null,
      "country_of_residence": "United Kingdom"
    }
  ],
  "company_link": "https://find-and-update.company-information.service.gov.uk/company/14785367",
  "company_name": "MONZO BANK HOLDING GROUP LIMITED",
  "company_number": "14785367",
  "register_statement": "The company knows or has reasonable cause to believe that there is no registrable person or registrable relevant legal entity in relation to the company"
}
```

### Search companies

Operation `search_companies`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Search the UK public register by company name and return company details in result order. Some establishments do not show a company type, incorporation date or registered office address.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `page` | integer | no | `2` | Search results page to start from, for example 2. |
| `max_results` | integer | no | `3` | Maximum number of companies to return, for example 20. |
| `company_name` | string | yes | `"Monzo Bank"` | Company name to search, for example Tesco or Monzo Bank. |
| `include_dissolved` | boolean | no | `true` | Include dissolved companies in the results, for example true. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "company_name"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Search results page to start from, for example 2.",
      "x-fous-developer": true,
      "examples": [
        2
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of companies to return, for example 20.",
      "x-fous-developer": true,
      "examples": [
        3,
        4,
        5
      ]
    },
    "company_name": {
      "type": "string",
      "minLength": 1,
      "description": "Company name to search, for example Tesco or Monzo Bank.",
      "examples": [
        "Monzo Bank",
        "Tesco",
        "zzzxqprtnotcompany123"
      ]
    },
    "include_dissolved": {
      "type": "boolean",
      "default": false,
      "description": "Include dissolved companies in the results, for example true.",
      "examples": [
        true
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "max_results": 3,
      "company_name": "Monzo Bank"
    },
    {
      "max_results": 4,
      "company_name": "Tesco",
      "include_dissolved": true
    },
    {
      "company_name": "zzzxqprtnotcompany123"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `companies` | array |  | Companies in search-result order. |
| `companies[].link` | string | `"https://find-and-update.company-information.service.gov.uk/company/09446231"` | Companies House company page. |
| `companies[].status` | string | `"Active"` | Company status in words. |
| `companies[].company_name` | string | `"MONZO BANK LIMITED"` | Registered company name. |
| `companies[].company_type` | string or null | `"Private limited Company"` | Company type in words, if shown. |
| `companies[].company_number` | string | `"09446231"` | Companies House number. |
| `companies[].incorporation_date` | string or null | `"2015-02-18"` | Date incorporated, if shown. |
| `companies[].registered_office_address` | string or null | `"Broadwalk House, 5 Appold Street, London, England, EC2A 2AG"` | Registered office address on one line, if shown. |

**Example input**

```json
{
  "max_results": 3,
  "company_name": "Monzo Bank"
}
```

**Example output**

```json
{
  "companies": [
    {
      "link": "https://find-and-update.company-information.service.gov.uk/company/09446231",
      "status": "Active",
      "company_name": "MONZO BANK LIMITED",
      "company_type": "Private limited Company",
      "company_number": "09446231",
      "incorporation_date": "2015-02-18",
      "registered_office_address": "Broadwalk House, 5 Appold Street, London, England, EC2A 2AG"
    },
    {
      "link": "https://find-and-update.company-information.service.gov.uk/company/14785367",
      "status": "Active",
      "company_name": "MONZO BANK HOLDING GROUP LIMITED",
      "company_type": "Private limited Company",
      "company_number": "14785367",
      "incorporation_date": "2023-04-06",
      "registered_office_address": "Broadwalk House, 5, Appold Street, London, United Kingdom, EC2A 2AG"
    },
    {
      "link": "https://find-and-update.company-information.service.gov.uk/company/16527332",
      "status": "Active —  Active proposal to strike off",
      "company_name": "KIDS MONZO LIMITED",
      "company_type": "Private limited Company",
      "company_number": "16527332",
      "incorporation_date": "2025-06-18",
      "registered_office_address": "Former St. John The Evangelist, Burnley Road, Bacup, England, OL13 8AB"
    }
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@companies-house",
  "visibility": "public",
  "operation": "get_company_profile",
  "version": 1,
  "input": {
    "company": "00229606"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@companies-house\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_company_profile\",\n  \"version\": 1,\n  \"input\": {\n    \"company\": \"00229606\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@companies-house",
  "visibility": "public",
  "operation": "get_company_profile",
  "version": 1,
  "input": {
    "company": "00229606"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/companies-house`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_company_profile`: Get company profile. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_directors`: List directors. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_filing_history`: List filing history. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_owners`: List owners. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `search_companies`: Search companies. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-companies-house https://api.fous.com/mcp/tools/companies-house --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Find UK companies by name and review their status.
- Check registration details and upcoming filing dates.
- Review current and former company officers.
- Identify people with significant control.
- Track recent filings and their descriptions.

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Companies House tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Companies House account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from find-and-update.company-information.service.gov.uk when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 28, 2026.

### What is a company’s current status?

Get company profile returns the company’s status and public registration details.

### Who are a company’s directors?

List directors returns current officers and, optionally, resigned officers.

### What has a company recently filed?

List filing history returns recent filings with dates and descriptions.

## Related

- [SEC EDGAR API](https://fous.com/tools/sec-edgar.md): SEC EDGAR provides filings, annual and quarterly financials, exact-phrase matches, up to 200 insider trades, and quarterly 13F manager holdings; older filings appear when available.
- [Trustpilot API](https://fous.com/tools/trustpilot.md): Trustpilot provides company ratings, reply and location details when available, recent public reviews, and company search results with ratings, review counts, categories, locations, and links.
- [GOV.UK API](https://fous.com/tools/gov-uk.md): GOV.UK provides summarized current travel advice with linked details, published regional holidays (none for unpublished years), and possible matches on the current UK Sanctions List.
- [Annuaire des Entreprises API](https://fous.com/tools/annuaire-des-entreprises.md): French government directory of public company registrations.
- [North Data API](https://fous.com/tools/north-data.md): Public company register information for European companies.
- [ABN Lookup API](https://fous.com/tools/abn-lookup.md): Search Australian businesses by name or ABN and check public registration details.
- [Forbes API](https://fous.com/tools/forbes.md): Forbes provides business news, real-time billionaire rankings and wealth that can change during the trading day, plus ranked Global 2000 companies with financial figures and company profiles.
- [Food Standards Agency API](https://fous.com/tools/food-standards-agency.md): Official UK food hygiene ratings for food businesses.
- [All Government tools](https://fous.com/tools/category/government)