‘Company profile’ resource specification update

API Changes
1

‘Company profile’ resource specification update

Please be advised the Company profile specification will shortly be extended to include an additional value of ‘corporate annotation’ - a corporate level message published by Companies House about a company, or situations affecting the company, or its information.

Effective date:
Early 2025

Data structure:

"data" : {
    "corporate_annotation": [ 
    {
        "created_on": "date",
        "description": "string",
        "type" : "string"
    },
]
}

Data properties:
corporate_annotation[] array A corporate level message published by Companies House about a company, or situations affecting the company, or its information. Optional
corporate_annotation[].created_on date The date on which the corporate annotation was created. Mandatory
corporate_annotation[].description string The details of a corporate annotation which has a corporate_annotation.type of “other” Optional
corporate_annotation[].type string The type of corporate annotation. For enumeration descriptions please see corporate_annotation_type in the enumerations Optional

Known possible ‘types’ at go live include:
‘strike-off-under-section-1002a-of-the-companies-act-2006-incorporation’
‘strike-off-under-section-1002a-of-the-companies-act-2006-restoration’

Further information/changes can be found at:

The following resource specifications will include the additional data:
https://developer-specs.company-information.service.gov.uk/companies-house-public-data-api/reference/company-profile
https://developer-specs.company-information.service.gov.uk/streaming-api/reference/company-information/stream