Skip to content

Company Data Types

All data types serialized dynamically when using the Companies House REST API.

CompanyToolResponse

Field Type Description
type string Statically bound to "companieshouse".
results UnifiedResult[] Mixed array for query types.

UnifiedResult

This implements the combined format returned by the proxy API.

Field Type Description
searchType string "companies" or "officers".
company CompanyProfileResponse Data populated if companies match. (Optional)
officer Object Data populated if officers match. (Optional)

CompanyProfileResponse

Field Type Description
company_number string Registration ID.
company_status string Legal operational flag index.
title string Formal title reference.
company_type string Registration category text format.
address_snippet string Condensed contact format location.
date_of_creation string Starting valid registration mark.
date_of_cessation string Ending valid reference time. (Optional)
links Object Context dictionary.
address Object City and line contexts.
matches Object Title regex matched fragments.
description string Legal format. (Optional)
description_identifier string[] Formats arrays. (Optional)
kind string API classification mapping.
snippet string Result preview values block.

CompanyProfile

Used by direct lookups.

Field Type Description
company_name string Label reference matching value.
company_number string Target ID limit.
company_status string Flag indicating closure checks.
company_status_detail string Added variable information text. (Optional)
date_of_creation string Open time reference index.
registered_office_address Object Specific physical mapping.
sic_codes string[] Trade class evaluation.
previous_company_names Object[] Alternate IDs recorded before. (Optional)
has_been_liquidated boolean Insolvency indicator. (Optional)
has_insolvency_history boolean Legal variable mapping boolean. (Optional)
has_charges boolean Debt logic mapping variables. (Optional)
undeliverable_registered_office_address boolean Contact error evaluation output. (Optional)
branch_company_details Object Reference mapping limits. (Optional)
foreign_company_details Object International contexts values limits. (Optional)
links Object Associated URL limits array.