Companies House Public Data API: List of dissolved companies

Methods

get - Search for a dissolved company

Resource

{
    "etag": "string",
    "hits": "string",
    "items": [
        {
            "company_name": "string",
            "company_number": "string",
            "company_status": "string",
            "date_of_cessation": "date",
            "date_of_creation": "date",
            "kind": "string",
            "matched_previous_company_name": {
                "ceased_on": "date",
                "company_number": "string",
                "effective_from": "date",
                "name": "string"
            },
            "ordered_alpha_key_with_id": "string",
            "previous_company_names": [
                {
                    "ceased_on": "date",
                    "company_number": "string",
                    "effective_from": "date",
                    "name": "string"
                }
            ],
            "registered_office_address": {
                "address_line_1": "string",
                "address_line_2": "string",
                "locality": "string",
                "postal_code": "string"
            }
        }
    ],
    "kind": "string",
    "top_hit": {
        "company_name": "string",
        "company_number": "string",
        "company_status": "string",
        "date_of_cessation": "date",
        "date_of_creation": "date",
        "kind": "string",
        "matched_previous_company_name": {
            "ceased_on": "date",
            "company_number": "string",
            "effective_from": "date",
            "name": "string"
        },
        "ordered_alpha_key_with_id": "string",
        "previous_company_names": [
            {
                "ceased_on": "date",
                "company_number": "string",
                "effective_from": "date",
                "name": "string"
            }
        ],
        "registered_office_address": {
            "address_line_1": "string",
            "address_line_2": "string",
            "locality": "string",
            "postal_code": "string"
        }
    }
}

Properties

Name	Type	Description	Additional
etag	string		Optional
hits	string	The number of hits returned on a best-match or previous-company-names search	Optional
items[]	array		Optional
items[].company_name	string	The company name associated with the dissolved company
items[].company_number	string	The company number of the dissolved company
items[].company_status	string	The status of the company	Optional
items[].date_of_cessation	date	The date that the company was dissolved
items[].date_of_creation	date	The date that the company was incorporated
items[].kind	string	The type of search result Possible values are: `search-results#dissolved-company`	Optional
items[].matched_previous_company_name	object	Previous company name	Optional
items[].matched_previous_company_name.ceased_on	date	The date that the company ceased being known under the company name	Optional
items[].matched_previous_company_name.company_number	string	The company number of the dissolved company	Optional
items[].matched_previous_company_name.effective_from	date	The date that the company started being known under the company name	Optional
items[].matched_previous_company_name.name	string	The previous name of the company	Optional
items[].ordered_alpha_key_with_id	string	The alphakey with it's id associated with the dissolved company	Optional
items[].previous_company_names[]	array		Optional
items[].previous_company_names[].ceased_on	date	The date that the company ceased being known under the company name	Optional
items[].previous_company_names[].company_number	string	The company number of the dissolved company	Optional
items[].previous_company_names[].effective_from	date	The date that the company started being known under the company name	Optional
items[].previous_company_names[].name	string	The previous name of the company	Optional
items[].registered_office_address	object	This will only appear if there are ROA details in the company record	Optional
items[].registered_office_address.address_line_1	string	The first line of the address e.g Crown Way	Optional
items[].registered_office_address.address_line_2	string	The second line of the address	Optional
items[].registered_office_address.locality	string	The town associated to the ROA e.g Cardiff	Optional
items[].registered_office_address.postal_code	string	The postal code e.g CF14 3UZ	Optional
kind	string	Possible values are: `search#alphabetical-dissolved` `search#dissolved` `search#previous-name-dissolved`	Optional
top_hit	object		Optional
top_hit.company_name	string	The company name associated with the dissolved company
top_hit.company_number	string	The company number of the dissolved company
top_hit.company_status	string	The status of the company	Optional
top_hit.date_of_cessation	date	The date that the company was dissolved
top_hit.date_of_creation	date	The date that the company was incorporated
top_hit.kind	string	The type of search result Possible values are: `search-results#dissolved-company`	Optional
top_hit.matched_previous_company_name	object	Previous company name	Optional
top_hit.matched_previous_company_name.ceased_on	date	The date that the company ceased being known under the company name	Optional
top_hit.matched_previous_company_name.company_number	string	The company number of the dissolved company	Optional
top_hit.matched_previous_company_name.effective_from	date	The date that the company started being known under the company name	Optional
top_hit.matched_previous_company_name.name	string	The previous name of the company	Optional
top_hit.ordered_alpha_key_with_id	string	The alphakey with it's id associated with the dissolved company	Optional
top_hit.previous_company_names[]	array		Optional
top_hit.previous_company_names[].ceased_on	date	The date that the company ceased being known under the company name	Optional
top_hit.previous_company_names[].company_number	string	The company number of the dissolved company	Optional
top_hit.previous_company_names[].effective_from	date	The date that the company started being known under the company name	Optional
top_hit.previous_company_names[].name	string	The previous name of the company	Optional
top_hit.registered_office_address	object	This will only appear if there are ROA details in the company record	Optional
top_hit.registered_office_address.address_line_1	string	The first line of the address e.g Crown Way	Optional
top_hit.registered_office_address.address_line_2	string	The second line of the address	Optional
top_hit.registered_office_address.locality	string	The town associated to the ROA e.g Cardiff	Optional
top_hit.registered_office_address.postal_code	string	The postal code e.g CF14 3UZ	Optional

List of dissolved companies resource

Methods

Resource

Properties