Companies House

Capability: Company Records

Market: UK

Business Capabilities

Search the Companies House Public Data API. Start by searching for a company by name to retrieve its registration number and basic details. Then use the company number to get information about active directors, persons with significant control, charges, jurisdiction, date of creation, and more.

Exposed Endpoints

• Search by Company Name: /api/house/v1/searchByName/{companyName} - Retrieves a list of possible matches with basic information including the company number.
• Get Company Details by Number: /api/house/v1/searchByNumber/{companyNumber} - Retrieves detailed information including jurisdiction, status, type, active officers, and persons with significant control.

Vault Configuration

• api-key - API key for the Companies House API (plain text).
• url-key - Base URL of the Companies House API.

Request Structures and Samples

/api/house/v1/searchByName/{companyName}

Sample endpoint: /api/house/v1/searchByName/fintechos

Sample response (abbreviated):

{
    "items": [
        {
            "company_name": "FINTECHOS TECHNOLOGY UK LTD",
            "company_number": "11857916",
            "company_status": "active",
            "company_type": "ltd",
            "date_of_creation": "2019-03-04",
            "registered_office_address": {
                "address_line_1": "6th Floor 9 Appold Street",
                "locality": "London",
                "postal_code": "EC2A 2AP",
                "country": "United Kingdom"
            }
        }
    ],
    "hits": 5
}

/api/house/v1/searchByNumber/{companyNumber}

Sample endpoint: /api/house/v1/searchByNumber/01122503

Sample response (abbreviated):

{
    "company_name": "GOLDMAN SACHS INTERNATIONAL BANK",
    "company_number": "01122503",
    "company_status": "active",
    "date_of_creation": "1973-07-12",
    "has_charges": true,
    "jurisdiction": "england-wales",
    "type": "private-unlimited",
    "active_officers": [
        {
            "name": "GOLDMAN SACHS SECRETARIAL SERVICES LIMITED",
            "officer_role": "corporate-secretary",
            "appointed_on": "2019-12-16"
        }
    ],
    "persons_with_significant_control": [
        {
            "name": "Goldman Sachs Group Uk Limited",
            "natures_of_control": ["ownership-of-shares-75-to-100-percent"]
        }
    ]
}

Error Codes

• {companyNumber}: Returns 404 if company number is not found (when length is 8), otherwise 500.
• {companyName}: Returns 404 if company name is not found.