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