# 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/workflows/companies-house
- Handle: `@companies-house`
- Category: [Government](https://fous.com/workflows/category/government)
- Source website: https://find-and-update.company-information.service.gov.uk
- Last verified: Sep 28, 2026
- Fous is not affiliated with Companies House.

## Methods

### Get company profile

Operation `get_company_profile`, version 1. 1 credit per call.

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 call.

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": "00445790",
  "max_results": 20,
  "include_resigned": "no"
}
```

**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 call.

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 call.

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 call.

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

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

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=120) 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.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_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);
```

Or describe the data in plain language: send `{"api":"@companies-house","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

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

### Is Fous affiliated with Companies House?

No. Fous is not affiliated with Companies House. This workflow reads the public find-and-update.company-information.service.gov.uk website and returns its data.

### How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check 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/workflows/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/workflows/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/workflows/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/workflows/annuaire-des-entreprises.md): French government directory of public company registrations.
- [North Data API](https://fous.com/workflows/north-data.md): Public company register information for European companies.
- [ABN Lookup API](https://fous.com/workflows/abn-lookup.md): Search Australian businesses by name or ABN and check public registration details.
- [Forbes API](https://fous.com/workflows/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/workflows/food-standards-agency.md): Official UK food hygiene ratings for food businesses.
- [All Government workflows](https://fous.com/workflows/category/government)