# Information

**URL:** http://forum.companieshouse.gov.uk/c/api-changes/information/18.md

[Latest](http://forum.companieshouse.gov.uk/latest.md) · [Categories](http://forum.companieshouse.gov.uk/categories.md)

---

## [About the Information category](http://forum.companieshouse.gov.uk/t/about-the-information-category/349)

<div class="topic-metadata">

**Author:** [@csmith](http://forum.companieshouse.gov.uk/u/csmith)\
**Replies:** 0

</div>

\[Replace this first paragraph with a short description of your new category. This guidance will appear in the category selection area, so try to keep it below 200 characters. Until you edit this text or create topics, th…

---

## [Loading of new persons with significant control data](http://forum.companieshouse.gov.uk/t/loading-of-new-persons-with-significant-control-data/13064)

<div class="topic-metadata">

**Author:** [@cbaldwin](http://forum.companieshouse.gov.uk/u/cbaldwin)\
**Replies:** 0\
**Last updated:** [October 8, 2026, 2:14pm UTC](http://forum.companieshouse.gov.uk/t/loading-of-new-persons-with-significant-control-data/13064 "2026-10-08T14:14:56Z")

</div>

Please be advised it is our intention to begin loading the new data item previously mentioned in 'Persons with significant control' resource specifications update from 08:00 on Tuesday 13th October. This will result in a…

---

## [Upcoming Change to Transaction Resource Specification](http://forum.companieshouse.gov.uk/t/upcoming-change-to-transaction-resource-specification/13038)

<div class="topic-metadata">

**Author:** [@kbaird](http://forum.companieshouse.gov.uk/u/kbaird)\
**Replies:** 0\
**Last updated:** [September 29, 2026, 10:50am UTC](http://forum.companieshouse.gov.uk/t/upcoming-change-to-transaction-resource-specification/13038 "2026-09-29T10:50:58Z")

</div>

We would like to provide advance notice of an upcoming update to the transaction resource specification: Specification: Manipulate Company Data (API Filing): transaction A new status value, received, will be added to t…

---

## [New resource: 'Persons with significant control notifications'](http://forum.companieshouse.gov.uk/t/new-resource-persons-with-significant-control-notifications/12761)

<div class="topic-metadata">

**Author:** [@cbaldwin](http://forum.companieshouse.gov.uk/u/cbaldwin)\
**Replies:** 0\
**Last updated:** [April 27, 2026, 7:38am UTC](http://forum.companieshouse.gov.uk/t/new-resource-persons-with-significant-control-notifications/12761 "2026-04-27T07:38:46Z")

</div>

For further details please see: Companies House Public Data API: Persons with significant control notifications N.B. This is early notification of a future resource. Development of this new resource is on-going so t…

---

## ['Persons with significant control' resource specifications update](http://forum.companieshouse.gov.uk/t/persons-with-significant-control-resource-specifications-update/12760)

<div class="topic-metadata">

**Author:** [@cbaldwin](http://forum.companieshouse.gov.uk/u/cbaldwin)\
**Replies:** 0\
**Last updated:** [April 27, 2026, 7:34am UTC](http://forum.companieshouse.gov.uk/t/persons-with-significant-control-resource-specifications-update/12760 "2026-04-27T07:34:13Z")

</div>

Please be advised that changes have been made to several persons with significant control (PSC) specification reference/resource pages to ensure they accurately reflect existing GET request/response content which will en…

---

## ['Super Secure person with significant control' resource specification update](http://forum.companieshouse.gov.uk/t/super-secure-person-with-significant-control-resource-specification-update/12371)

<div class="topic-metadata">

**Author:** [@cbaldwin](http://forum.companieshouse.gov.uk/u/cbaldwin)\
**Replies:** 0\
**Last updated:** [November 7, 2025, 1:30pm UTC](http://forum.companieshouse.gov.uk/t/super-secure-person-with-significant-control-resource-specification-update/12371 "2025-11-07T13:30:40Z")

</div>

As a result of 'Officers' and ‘Persons with significant control’ resource specification update please now also be advised of the following change to Companies House Public Data API: superSecure “identity\_verification\_de…

---

## ['Officers' and 'Persons with significant control resource specification - Identify Verification update (v2)](http://forum.companieshouse.gov.uk/t/officers-and-persons-with-significant-control-resource-specification-identify-verification-update-v2/12257)

<div class="topic-metadata">

**Author:** [@cbaldwin](http://forum.companieshouse.gov.uk/u/cbaldwin)\
**Replies:** 0\
**Last updated:** [October 20, 2025, 10:59am UTC](http://forum.companieshouse.gov.uk/t/officers-and-persons-with-significant-control-resource-specification-identify-verification-update-v2/12257 "2025-10-20T10:59:31Z")

</div>

Please note the published specifications are incorrect and will be updated as soon as possible. As per the original guidance the naming convention for the identity verification object will be: “identity\_verification\_de…

---

## [‘Officers’ and ‘Persons with significant control’ resource specification - Identity Verification update](http://forum.companieshouse.gov.uk/t/officers-and-persons-with-significant-control-resource-specification-identity-verification-update/12246)

<div class="topic-metadata">

**Author:** [@cbaldwin](http://forum.companieshouse.gov.uk/u/cbaldwin)\
**Replies:** 0\
**Last updated:** [October 16, 2025, 1:38pm UTC](http://forum.companieshouse.gov.uk/t/officers-and-persons-with-significant-control-resource-specification-identity-verification-update/12246 "2025-10-16T13:38:24Z")

</div>

Changes to both officer and persons with significant control specifications resulting from upcoming identity verification requirements will be published in the next few days. For further details please see original commu…

---

## [Removal of officer 'occupation' - for information](http://forum.companieshouse.gov.uk/t/removal-of-officer-occupation-for-information/12247)

<div class="topic-metadata">

**Author:** [@cbaldwin](http://forum.companieshouse.gov.uk/u/cbaldwin)\
**Replies:** 0\
**Last updated:** [October 16, 2025, 1:45pm UTC](http://forum.companieshouse.gov.uk/t/removal-of-officer-occupation-for-information/12247 "2025-10-16T13:45:41Z")

</div>

From 18th November 2025 the requirement for company officers to provide Companies House with a business occupation will be removed and there will be no mechanism for an individual to update their occupation on the regist…

---

## ['Persons with significant control statement' - New statement\_description](http://forum.companieshouse.gov.uk/t/persons-with-significant-control-statement-new-statement-description/12245)

<div class="topic-metadata">

**Author:** [@cbaldwin](http://forum.companieshouse.gov.uk/u/cbaldwin)\
**Replies:** 0\
**Last updated:** [October 16, 2025, 1:34pm UTC](http://forum.companieshouse.gov.uk/t/persons-with-significant-control-statement-new-statement-description/12245 "2025-10-16T13:34:56Z")

</div>

Please be advised a new persons with significant control ‘statement\_description’ will be available from 18th November 2025: awaiting-confirmation-from-psc The ‘persons with significant control statement’ specification …

---

## ['Officers' and ‘Persons with significant control’ resource specification update](http://forum.companieshouse.gov.uk/t/officers-and-persons-with-significant-control-resource-specification-update/12087)

<div class="topic-metadata">

**Author:** [@cbaldwin](http://forum.companieshouse.gov.uk/u/cbaldwin)\
**Replies:** 0\
**Last updated:** [September 9, 2025, 4:51pm UTC](http://forum.companieshouse.gov.uk/t/officers-and-persons-with-significant-control-resource-specification-update/12087 "2025-09-09T16:51:08Z")

</div>

Please be advised that from Tuesday 18th November 2025, legal requirements for directors and people with significant control (PSCs) of companies to verify their identities will begin. Please see Companies House confirms…

---

## ['Streaming API' - Officers stream](http://forum.companieshouse.gov.uk/t/streaming-api-officers-stream/12086)

<div class="topic-metadata">

**Author:** [@cbaldwin](http://forum.companieshouse.gov.uk/u/cbaldwin)\
**Replies:** 0\
**Last updated:** [September 9, 2025, 4:23pm UTC](http://forum.companieshouse.gov.uk/t/streaming-api-officers-stream/12086 "2025-09-09T16:23:16Z")

</div>

Please be advised that as detailed in the officersStream specification at Streaming API: officersStream, where possible an ‘etag’ value will shortly be included in messages for the “resource\_kind”:“company-officers”.

---

## [‘Company profile’ - corporate annotation 'type' update](http://forum.companieshouse.gov.uk/t/company-profile-corporate-annotation-type-update/12085)

<div class="topic-metadata">

**Author:** [@cbaldwin](http://forum.companieshouse.gov.uk/u/cbaldwin)\
**Replies:** 0\
**Last updated:** [September 9, 2025, 4:14pm UTC](http://forum.companieshouse.gov.uk/t/company-profile-corporate-annotation-type-update/12085 "2025-09-09T16:14:51Z")

</div>

Please be advised that from 1st October 2025 there will be a new corporate level annotation ‘type’ of: ‘overseas-entity-dissolved-wound-up-or-ceased-to-exist’. Previous information relating to ‘corporate annotations’ c…

---

## ['Company profile' - corporate annotation update](http://forum.companieshouse.gov.uk/t/company-profile-corporate-annotation-update/11623)

<div class="topic-metadata">

**Author:** [@cbaldwin](http://forum.companieshouse.gov.uk/u/cbaldwin)\
**Replies:** 0\
**Last updated:** [June 4, 2025, 7:44am UTC](http://forum.companieshouse.gov.uk/t/company-profile-corporate-annotation-update/11623 "2025-06-04T07:44:51Z")

</div>

Please see previous communication at ‘Company profile’ resource specification update It is now confirmed that corporate level annotations will be used from 9th June 2025. As previously advised the ‘types’ of ‘strike-of…

---

## ['DocumentMetadata' resource specification update](http://forum.companieshouse.gov.uk/t/documentmetadata-resource-specification-update/11365)

<div class="topic-metadata">

**Author:** [@cbaldwin](http://forum.companieshouse.gov.uk/u/cbaldwin)\
**Replies:** 0\
**Last updated:** [April 2, 2025, 8:41am UTC](http://forum.companieshouse.gov.uk/t/documentmetadata-resource-specification-update/11365 "2025-04-02T08:41:55Z")

</div>

Please be advised that a change is imminent to the DocumentMetadata resource specification The description of the property ‘resources.{content\_type}’ will be amended to include an additional content-type of application/…

---

## [‘Officer disqualifications’ resource specification update](http://forum.companieshouse.gov.uk/t/officer-disqualifications-resource-specification-update/10989)

<div class="topic-metadata">

**Author:** [@cbaldwin](http://forum.companieshouse.gov.uk/u/cbaldwin)\
**Replies:** 0\
**Last updated:** [February 10, 2025, 8:12am UTC](http://forum.companieshouse.gov.uk/t/officer-disqualifications-resource-specification-update/10989 "2025-02-10T08:12:38Z")

</div>

Please be advised of that changes will shortly be made to the officer disqualifications specifications at Companies House Public Data API: Officer disqualifications and Streaming API: Disqualified officers. The descript…

---

## [‘Streaming API’ resources specification update](http://forum.companieshouse.gov.uk/t/streaming-api-resources-specification-update/10518)

<div class="topic-metadata">

**Author:** [@cbaldwin](http://forum.companieshouse.gov.uk/u/cbaldwin)\
**Replies:** 0\
**Last updated:** [December 17, 2024, 8:53am UTC](http://forum.companieshouse.gov.uk/t/streaming-api-resources-specification-update/10518 "2024-12-17T08:53:21Z")

</div>

Please be advised the ‘data’ object in all of the Streaming API specifications e.g. Streaming API: companyProfileStream has been revised to an ‘optional’ item. This is to ensure that in all eventualities an event type of…

---

## [Upcoming changes to the api and stream responses](http://forum.companieshouse.gov.uk/t/upcoming-changes-to-the-api-and-stream-responses/5299)

<div class="topic-metadata">

**Author:** [@MArkWilliams](http://forum.companieshouse.gov.uk/u/MArkWilliams)\
**Replies:** 0\
**Last updated:** [July 29, 2022, 8:45am UTC](http://forum.companieshouse.gov.uk/t/upcoming-changes-to-the-api-and-stream-responses/5299 "2022-07-29T08:45:06Z")

</div>

There will be changes made to the following specifications to align with the data that is being returned from the api and stream responses; Insolvency - Companies House Public Data API: companyInsolvency (company-inform…

---

## [IP address changes](http://forum.companieshouse.gov.uk/t/ip-address-changes/2493)

<div class="topic-metadata">

**Author:** [@MArkWilliams](http://forum.companieshouse.gov.uk/u/MArkWilliams)\
**Replies:** 2\
**Last updated:** [July 16, 2019, 3:25pm UTC](http://forum.companieshouse.gov.uk/t/ip-address-changes/2493 "2019-07-16T15:25:11Z")

</div>

Due to essential maintenance the IP addresses of api.companieshouse.gov.uk will be changing very soon. If you are accessing the api by IP address, you will need to update or preferably switch to using the address api.co…

---

## [TLSv1.0 retirement](http://forum.companieshouse.gov.uk/t/tlsv1-0-retirement/2392)

<div class="topic-metadata">

**Author:** [@MArkWilliams](http://forum.companieshouse.gov.uk/u/MArkWilliams)\
**Replies:** 2\
**Last updated:** [May 16, 2019, 1:47pm UTC](http://forum.companieshouse.gov.uk/t/tlsv1-0-retirement/2392 "2019-05-16T13:47:50Z")

</div>

We will be removing support for TLSv1.0 very soon. If you are still using TLSv1.0, you will have already been contacted and informed some time ago. There will be one further announcement giving a specific date for the …

---

## [403 Forbidden when accessing the API](http://forum.companieshouse.gov.uk/t/403-forbidden-when-accessing-the-api/2228)

<div class="topic-metadata">

**Author:** [@MArkWilliams](http://forum.companieshouse.gov.uk/u/MArkWilliams)\
**Replies:** 0\
**Last updated:** [February 27, 2019, 4:26pm UTC](http://forum.companieshouse.gov.uk/t/403-forbidden-when-accessing-the-api/2228 "2019-02-27T16:26:49Z")

</div>

We have recently tightened up security around restricted IPs. If you are getting 403’s you will have to either update your API account Restricted IPs to ensure you have the correct IP addresses or remove them altogethe…

---

## [Fair Use Policy Reminder](http://forum.companieshouse.gov.uk/t/fair-use-policy-reminder/1501)

<div class="topic-metadata">

**Author:** [@SteveBowen](http://forum.companieshouse.gov.uk/u/SteveBowen)\
**Replies:** 0\
**Last updated:** [December 4, 2017, 1:42pm UTC](http://forum.companieshouse.gov.uk/t/fair-use-policy-reminder/1501 "2017-12-04T13:42:31Z")

</div>

Companies House would like to apologise for the quality of service that customers received towards the end of last week. This was primarily due to a small minority of customer exceeding rate limits. This has caused ser…

---

## [Scheduled Maintenance Saturday 11 November 2017](http://forum.companieshouse.gov.uk/t/scheduled-maintenance-saturday-11-november-2017/1458)

<div class="topic-metadata">

**Author:** [@MArkWilliams](http://forum.companieshouse.gov.uk/u/MArkWilliams)\
**Replies:** 0\
**Last updated:** [November 10, 2017, 12:38pm UTC](http://forum.companieshouse.gov.uk/t/scheduled-maintenance-saturday-11-november-2017/1458 "2017-11-10T12:38:10Z")

</div>

Scheduled Maintenance: We’ll be carrying out some planned maintenance on our internal systems from 08:00 Saturday 11 November 2017 to 12:00 Monday 13 November 2017. Although not anticipated, Companies House Service may …

---

## [Adding new API enumerations to constants and filing history exceptions](http://forum.companieshouse.gov.uk/t/adding-new-api-enumerations-to-constants-and-filing-history-exceptions/1384)

<div class="topic-metadata">

**Author:** [@jrichards](http://forum.companieshouse.gov.uk/u/jrichards)\
**Replies:** 0\
**Last updated:** [October 5, 2017, 12:25pm UTC](http://forum.companieshouse.gov.uk/t/adding-new-api-enumerations-to-constants-and-filing-history-exceptions/1384 "2017-10-05T12:25:14Z")

</div>

Change: To add new API enumerations to constants and filing history exceptions This change will add filing history exceptions and constants API enumerations. Resources Affected: constants.yml and filing\_history\_execpti…

---

## [Search API issues](http://forum.companieshouse.gov.uk/t/search-api-issues/1222)

<div class="topic-metadata">

**Author:** [@MArkWilliams](http://forum.companieshouse.gov.uk/u/MArkWilliams)\
**Replies:** 0\
**Last updated:** [July 5, 2017, 11:11am UTC](http://forum.companieshouse.gov.uk/t/search-api-issues/1222 "2017-07-05T11:11:20Z")

</div>

We experienced issues with the search API earlier today between 11am and 12 noon. Sorry for the inconvenience.

---

## [New Restoration Filing History Descriptions](http://forum.companieshouse.gov.uk/t/new-restoration-filing-history-descriptions/1220)

<div class="topic-metadata">

**Author:** [@emead](http://forum.companieshouse.gov.uk/u/emead)\
**Replies:** 0\
**Last updated:** [July 5, 2017, 7:52am UTC](http://forum.companieshouse.gov.uk/t/new-restoration-filing-history-descriptions/1220 "2017-07-05T07:52:59Z")

</div>

Change: to add new filing history descriptions Implementation Date for enumerations additions: 09/08/2017 Resources Affected: filing\_history\_descriptions.yml This change will add 3 new filing history enumerations for …

---

## [New Insolvency Filing History Descriptions](http://forum.companieshouse.gov.uk/t/new-insolvency-filing-history-descriptions/1193)

<div class="topic-metadata">

**Author:** [@emead](http://forum.companieshouse.gov.uk/u/emead)\
**Replies:** 0\
**Last updated:** [June 14, 2017, 8:21am UTC](http://forum.companieshouse.gov.uk/t/new-insolvency-filing-history-descriptions/1193 "2017-06-14T08:21:25Z")

</div>

Change: to add new filing history descriptions Implementation Date for enumerations additions: 26/06/2017 Resources Affected: filing\_history\_descriptions.yml This change will add 6 new filing history enumerations for …

---

## [New filing history descriptions and constants enumerations](http://forum.companieshouse.gov.uk/t/new-filing-history-descriptions-and-constants-enumerations/1158)

<div class="topic-metadata">

**Author:** [@mransome](http://forum.companieshouse.gov.uk/u/mransome)\
**Replies:** 0\
**Last updated:** [May 9, 2017, 7:44am UTC](http://forum.companieshouse.gov.uk/t/new-filing-history-descriptions-and-constants-enumerations/1158 "2017-05-09T07:44:26Z")

</div>

Change: To add new constants and filing history descriptions Implementation Date for enumeration additions: 24/05/2017 Resources Affected: constants.yml and filing\_history\_descriptions.yml Pull Requests: https://gith…

---

## [Scheduled Maintenance](http://forum.companieshouse.gov.uk/t/scheduled-maintenance/1121)

<div class="topic-metadata">

**Author:** [@mfairhurst](http://forum.companieshouse.gov.uk/u/mfairhurst)\
**Replies:** 0\
**Last updated:** [April 13, 2017, 2:19pm UTC](http://forum.companieshouse.gov.uk/t/scheduled-maintenance/1121 "2017-04-13T14:19:50Z")

</div>

The API service will have planned maintenance between 23:59 on Thursday 13 April and 07:00 on Tuesday 18 April. You won’t be able to file a change of registered office address (AD01) or use the Follow service during this…

---

## [Good API implementation](http://forum.companieshouse.gov.uk/t/good-api-implementation/1076)

<div class="topic-metadata">

**Author:** [@davmarksman2](http://forum.companieshouse.gov.uk/u/davmarksman2)\
**Replies:** 0\
**Last updated:** [March 26, 2017, 11:23pm UTC](http://forum.companieshouse.gov.uk/t/good-api-implementation/1076 "2017-03-26T23:23:39Z")

</div>

Not sure how much feedback you guys get but I liked it and very easy to use. Good job guys!

[Next page](http://forum.companieshouse.gov.uk/c/api-changes/information/18.md?page=1)
