# API Enhancements

**URL:** http://forum.companieshouse.gov.uk/c/api-enhancements/24.md

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

---

## [About the API Enhancements category](http://forum.companieshouse.gov.uk/t/about-the-api-enhancements-category/1168)

<div class="topic-metadata">

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

</div>

Please use this topic to request enhancements to the API.

---

## [Rate limit increase request — from an academic researcher in dublin](http://forum.companieshouse.gov.uk/t/rate-limit-increase-request-from-an-academic-researcher-in-dublin/12951)

<div class="topic-metadata">

**Author:** [@mengyao.zhang5](http://forum.companieshouse.gov.uk/u/mengyao.zhang5)\
**Replies:** 1\
**Last updated:** [August 21, 2026, 4:29pm UTC](http://forum.companieshouse.gov.uk/t/rate-limit-increase-request-from-an-academic-researcher-in-dublin/12951 "2026-08-21T16:29:53Z")

</div>

I am a PhD researcher at Dublin City University Business School. My project requires retrieving filing history and persons-with-significant-control records for a large defined set of UK registered companies. The total v…

---

## [Request to increase Companies House API rate limit for contractor due diligence](http://forum.companieshouse.gov.uk/t/request-to-increase-companies-house-api-rate-limit-for-contractor-due-diligence/12932)

<div class="topic-metadata">

**Author:** [@darrenboland](http://forum.companieshouse.gov.uk/u/darrenboland)\
**Replies:** 1\
**Last updated:** [August 17, 2026, 7:57am UTC](http://forum.companieshouse.gov.uk/t/request-to-increase-companies-house-api-rate-limit-for-contractor-due-diligence/12932 "2026-08-17T07:57:06Z")

</div>

Hi We are a Property Management Company that carries out due-diligence checks on contractors before they are added to, or retained within, our contractor database. As part of this process, we need to validate a high vo…

---

## [Help: Increase Rate Limit](http://forum.companieshouse.gov.uk/t/help-increase-rate-limit/12898)

<div class="topic-metadata">

**Author:** [@alaina.kwan](http://forum.companieshouse.gov.uk/u/alaina.kwan)\
**Replies:** 0\
**Last updated:** [July 23, 2026, 4:48pm UTC](http://forum.companieshouse.gov.uk/t/help-increase-rate-limit/12898 "2026-07-23T16:48:48Z")

</div>

Hi there, I’m using the REST API to backfill filings missed from the streaming API but am running into rate limit issues. Could my application get an increase please? Happy to share any details needed in private. Thank…

---

## [Increase Rate Limiting](http://forum.companieshouse.gov.uk/t/increase-rate-limiting/12886)

<div class="topic-metadata">

**Author:** [@ollie.powerhub](http://forum.companieshouse.gov.uk/u/ollie.powerhub)\
**Replies:** 1\
**Last updated:** [July 20, 2026, 2:04pm UTC](http://forum.companieshouse.gov.uk/t/increase-rate-limiting/12886 "2026-07-20T14:04:43Z")

</div>

Hi, I run read-only batch jobs against the API for some internal compliance work, and I’m hitting the 600 requests per 5 minutes limit as my list grows. Would it be possible to raise the rate limit on my registered appl…

---

## [I want to increase my API rate limit](http://forum.companieshouse.gov.uk/t/i-want-to-increase-my-api-rate-limit/12758)

<div class="topic-metadata">

**Author:** [@ciaran.mcallister](http://forum.companieshouse.gov.uk/u/ciaran.mcallister)\
**Replies:** 2\
**Last updated:** [May 13, 2026, 8:59am UTC](http://forum.companieshouse.gov.uk/t/i-want-to-increase-my-api-rate-limit/12758 "2026-05-13T08:59:02Z")

</div>

Hi, As part of an upgrade to the rates system for Northern Ireland I need to increase the CH API rate limit please? The primary requirement here is to protect the Online Self Service Portal, which is customer‑facing, an…

---

## [Allow filtering of filing history by document type](http://forum.companieshouse.gov.uk/t/allow-filtering-of-filing-history-by-document-type/12750)

<div class="topic-metadata">

**Author:** [@FE-Rlok](http://forum.companieshouse.gov.uk/u/FE-Rlok)\
**Replies:** 1\
**Last updated:** [April 15, 2026, 4:35am UTC](http://forum.companieshouse.gov.uk/t/allow-filtering-of-filing-history-by-document-type/12750 "2026-04-15T04:35:23Z")

</div>

Currently the filing history endpoint (/company/{company\_number}/filing-history) only allows filtering by category. I was wondering whether it would be possible to also implement filtering by specific document type (e.g.…

---

## [Could officer searches take a name and a month and year of birth?](http://forum.companieshouse.gov.uk/t/could-officer-searches-take-a-name-and-a-month-and-year-of-birth/3655)

<div class="topic-metadata">

**Author:** [@tom\_gallagher](http://forum.companieshouse.gov.uk/u/tom_gallagher)\
**Replies:** 4\
**Last updated:** [May 3, 2025, 2:58am UTC](http://forum.companieshouse.gov.uk/t/could-officer-searches-take-a-name-and-a-month-and-year-of-birth/3655 "2025-05-03T02:58:23Z")

</div>

The Q param is fairly useful but we could exclude a lot of false positives if we could add these additional parameters. Many thanks, Tom

---

## [When will Manipulate Company Data API improve?](http://forum.companieshouse.gov.uk/t/when-will-manipulate-company-data-api-improve/11359)

<div class="topic-metadata">

**Author:** [@charlander](http://forum.companieshouse.gov.uk/u/charlander)\
**Replies:** 0\
**Last updated:** [March 31, 2025, 4:38pm UTC](http://forum.companieshouse.gov.uk/t/when-will-manipulate-company-data-api-improve/11359 "2025-03-31T16:38:42Z")

</div>

When will the Manipulate Company Data API expand to cover more operations? We are looking to file change of director information, appointment and resignation of directors, confirmation statements, allotment of shares, an…

---

## [Streaming API ChunkedEncodingError](http://forum.companieshouse.gov.uk/t/streaming-api-chunkedencodingerror/10882)

<div class="topic-metadata">

**Author:** [@gabe.boucaud](http://forum.companieshouse.gov.uk/u/gabe.boucaud)\
**Replies:** 1\
**Last updated:** [February 7, 2025, 10:37am UTC](http://forum.companieshouse.gov.uk/t/streaming-api-chunkedencodingerror/10882 "2025-02-07T10:37:41Z")

</div>

In my connection to the streaming api, I have implemented error handling and retries after 60 seconds for the following error types: ChunkedEncodingError, ConnectionError, IncompleteRead, InvalidChunkLength, but some eve…

---

## [Duplicate API Calls Required - Officer Name](http://forum.companieshouse.gov.uk/t/duplicate-api-calls-required-officer-name/8160)

<div class="topic-metadata">

**Author:** [@james.prout](http://forum.companieshouse.gov.uk/u/james.prout)\
**Replies:** 3\
**Last updated:** [July 9, 2024, 2:52pm UTC](http://forum.companieshouse.gov.uk/t/duplicate-api-calls-required-officer-name/8160 "2024-07-09T14:52:18Z")

</div>

Hello, We are attempting to fetch the full name of an officer, including their name elements (Title/Honours etc) from the officer endpoint, for example: https://api.company-information.service.gov.uk/company/14196465/ap…

---

## [Filter SMEs for company search](http://forum.companieshouse.gov.uk/t/filter-smes-for-company-search/8104)

<div class="topic-metadata">

**Author:** [@florian](http://forum.companieshouse.gov.uk/u/florian)\
**Replies:** 1\
**Last updated:** [June 25, 2024, 3:30pm UTC](http://forum.companieshouse.gov.uk/t/filter-smes-for-company-search/8104 "2024-06-25T15:30:39Z")

</div>

Would it be possible to add a filter for company search, to be able to select either: micro small medium large company

---

## [Person Number - Merged](http://forum.companieshouse.gov.uk/t/person-number-merged/7719)

<div class="topic-metadata">

**Author:** [@pfwalsh77](http://forum.companieshouse.gov.uk/u/pfwalsh77)\
**Replies:** 0\
**Last updated:** [April 9, 2024, 2:42pm UTC](http://forum.companieshouse.gov.uk/t/person-number-merged/7719 "2024-04-09T14:42:59Z")

</div>

Great to see Person Number now included in Director’s API. Is there any plans to include old Person Number when PINs are merged?

---

## [Online "Company Snapshot" via API?](http://forum.companieshouse.gov.uk/t/online-company-snapshot-via-api/3147)

<div class="topic-metadata">

**Author:** [@peter\_bc](http://forum.companieshouse.gov.uk/u/peter_bc)\
**Replies:** 3\
**Last updated:** [July 13, 2023, 10:31am UTC](http://forum.companieshouse.gov.uk/t/online-company-snapshot-via-api/3147 "2023-07-13T10:31:45Z")

</div>

Hi CH team, The web front end at beta.companieshouse.gov.uk offers a new ‘Company Snapshot’ product under the ‘more’ tab. Will this product be offered through the API / Is it already? Thanks Pete BC

---

## [Company data access - equivalent to SEC APIs](http://forum.companieshouse.gov.uk/t/company-data-access-equivalent-to-sec-apis/6435)

<div class="topic-metadata">

**Author:** [@bvgkelly](http://forum.companieshouse.gov.uk/u/bvgkelly)\
**Replies:** 0\
**Last updated:** [June 14, 2023, 9:52am UTC](http://forum.companieshouse.gov.uk/t/company-data-access-equivalent-to-sec-apis/6435 "2023-06-14T09:52:24Z")

</div>

Hi, In the US it’s possible to access income statement data, balance sheets, etc by simply calling their APIs. However, with the UK I can’t invest as data is so difficult to access. Are there any plans to provide easy a…

---

## [name\_elements in company officers result](http://forum.companieshouse.gov.uk/t/name-elements-in-company-officers-result/2091)

<div class="topic-metadata">

**Author:** [@vincentgrey](http://forum.companieshouse.gov.uk/u/vincentgrey)\
**Replies:** 2\
**Last updated:** [June 7, 2023, 11:04am UTC](http://forum.companieshouse.gov.uk/t/name-elements-in-company-officers-result/2091 "2023-06-07T11:04:36Z")

</div>

Hi would it be possible to add the name\_elements to Company officers when getting them from a company? This information is included if you get the appointments of an officer directly or when you get the PSCs of a compan…

---

## [C# API Connection](http://forum.companieshouse.gov.uk/t/c-api-connection/4947)

<div class="topic-metadata">

**Author:** [@adil.krgl](http://forum.companieshouse.gov.uk/u/adil.krgl)\
**Replies:** 3\
**Last updated:** [May 25, 2023, 9:04pm UTC](http://forum.companieshouse.gov.uk/t/c-api-connection/4947 "2023-05-25T21:04:13Z")

</div>

I was just want to share my code example. Because when I start work with Companies House API I couldn’t find any information on c#. Any need any help or have any questions please let us know. public static string MainU…

---

## [Query anonymized discrepancies](http://forum.companieshouse.gov.uk/t/query-anonymized-discrepancies/6344)

<div class="topic-metadata">

**Author:** [@dragos.gorduza](http://forum.companieshouse.gov.uk/u/dragos.gorduza)\
**Replies:** 0\
**Last updated:** [May 23, 2023, 2:51pm UTC](http://forum.companieshouse.gov.uk/t/query-anonymized-discrepancies/6344 "2023-05-23T14:51:32Z")

</div>

Hello, I am interested in querying a dataset of discrepancies to automatically detect companies which commit fraud, finance terrorism or conceal business deals. I wanted to ask if there is either a bulk access to anonym…

---

## [Webhook / Following](http://forum.companieshouse.gov.uk/t/webhook-following/5301)

<div class="topic-metadata">

**Author:** [@ddenton](http://forum.companieshouse.gov.uk/u/ddenton)\
**Replies:** 1\
**Last updated:** [January 26, 2023, 11:15pm UTC](http://forum.companieshouse.gov.uk/t/webhook-following/5301 "2023-01-26T23:15:30Z")

</div>

Apologies if this is covered elsewhere or is possible using the existing stream API. We have approx. 6,000 corporate clients who are registered on Companies House. We currently use the API to frequently (Nightly) check …

---

## [Include the company\_name field when using the company number to get the registered address](http://forum.companieshouse.gov.uk/t/include-the-company-name-field-when-using-the-company-number-to-get-the-registered-address/5426)

<div class="topic-metadata">

**Author:** [@mark.bellingham](http://forum.companieshouse.gov.uk/u/mark.bellingham)\
**Replies:** 0\
**Last updated:** [September 2, 2022, 11:23am UTC](http://forum.companieshouse.gov.uk/t/include-the-company-name-field-when-using-the-company-number-to-get-the-registered-address/5426 "2022-09-02T11:23:21Z")

</div>

As the title really. I think that this would be a useful addition and would help to confirm that the searched for company number was the correct one. At the moment I am having to retrieve the whole profile when all I nee…

---

## [Person ID in Officer Stream API](http://forum.companieshouse.gov.uk/t/person-id-in-officer-stream-api/4687)

<div class="topic-metadata">

**Author:** [@b.buchhold](http://forum.companieshouse.gov.uk/u/b.buchhold)\
**Replies:** 0\
**Last updated:** [January 6, 2022, 10:48am UTC](http://forum.companieshouse.gov.uk/t/person-id-in-officer-stream-api/4687 "2022-01-06T10:48:35Z")

</div>

Right now, there seems to be no officer/person ID for appointments retrieved through the officer stream API. This makes it very hard to use this information and to reconcile mentions of the same person. The bulk data d…

---

## [Enhanced Sandbox Test Data Generator fields](http://forum.companieshouse.gov.uk/t/enhanced-sandbox-test-data-generator-fields/3927)

<div class="topic-metadata">

**Author:** [@george.walker](http://forum.companieshouse.gov.uk/u/george.walker)\
**Replies:** 0\
**Last updated:** [May 18, 2021, 2:19pm UTC](http://forum.companieshouse.gov.uk/t/enhanced-sandbox-test-data-generator-fields/3927 "2021-05-18T14:19:07Z")

</div>

It appears that when creating a test sandbox company using the data generator, the only field one can add is the company ‘jurisdiction’: https://developer-specs.company-information.service.gov.uk/sandbox-test-data-genera…

---

## [Additional parameters on Company profile](http://forum.companieshouse.gov.uk/t/additional-parameters-on-company-profile/2842)

<div class="topic-metadata">

**Author:** [@jamesvolland](http://forum.companieshouse.gov.uk/u/jamesvolland)\
**Replies:** 1\
**Last updated:** [February 9, 2020, 11:58pm UTC](http://forum.companieshouse.gov.uk/t/additional-parameters-on-company-profile/2842 "2020-02-09T23:58:16Z")

</div>

Could we get a point of reference on Company Profile of any changes for Fling History, Charge Officer Appointment PSC. At the moment (unless I am missing something) I have to use up 4 tokens to check through these 4 dif…

---

## [Get Company List while typing Company Name](http://forum.companieshouse.gov.uk/t/get-company-list-while-typing-company-name/2532)

<div class="topic-metadata">

**Author:** [@kunalmandloi](http://forum.companieshouse.gov.uk/u/kunalmandloi)\
**Replies:** 0\
**Last updated:** [August 6, 2019, 3:09pm UTC](http://forum.companieshouse.gov.uk/t/get-company-list-while-typing-company-name/2532 "2019-08-06T15:09:38Z")

</div>

How to get a List of Company from Company House while typing on textbox in .net c#

---

## [Disqualified directors](http://forum.companieshouse.gov.uk/t/disqualified-directors/2473)

<div class="topic-metadata">

**Author:** [@iankent1](http://forum.companieshouse.gov.uk/u/iankent1)\
**Replies:** 0\
**Last updated:** [June 24, 2019, 12:06pm UTC](http://forum.companieshouse.gov.uk/t/disqualified-directors/2473 "2019-06-24T12:06:15Z")

</div>

Hi It’d be really useful if the disqualified director endpoint response included the person number from the disqualified director dataset, and even better if we could use that to find the matching officer on the Compani…

---

## [Per User API Access Tokens](http://forum.companieshouse.gov.uk/t/per-user-api-access-tokens/2124)

<div class="topic-metadata">

**Author:** [@harry\_radford](http://forum.companieshouse.gov.uk/u/harry_radford)\
**Replies:** 1\
**Last updated:** [January 15, 2019, 3:35pm UTC](http://forum.companieshouse.gov.uk/t/per-user-api-access-tokens/2124 "2019-01-15T15:35:03Z")

</div>

Hi, The API currently allows for per application API keys, limiting the APIs use in terms of third-party services that would like to make use of it’s real-time data. Taking the standard approach of many APIs and impleme…

---

## [Get all current officers / not all officers from history](http://forum.companieshouse.gov.uk/t/get-all-current-officers-not-all-officers-from-history/1966)

<div class="topic-metadata">

**Author:** [@dan1](http://forum.companieshouse.gov.uk/u/dan1)\
**Replies:** 2\
**Last updated:** [August 16, 2018, 2:53pm UTC](http://forum.companieshouse.gov.uk/t/get-all-current-officers-not-all-officers-from-history/1966 "2018-08-16T14:53:49Z")

</div>

Hi, When trying to get current information on officers form CH api, we get a full list of all the the officers there ever was, there is now a button in the site to show only current, is there a way to do this right now …

---

## [RSS Feed to publish news of updates](http://forum.companieshouse.gov.uk/t/rss-feed-to-publish-news-of-updates/1903)

<div class="topic-metadata">

**Author:** [@alastair](http://forum.companieshouse.gov.uk/u/alastair)\
**Replies:** 1\
**Last updated:** [July 6, 2018, 1:03pm UTC](http://forum.companieshouse.gov.uk/t/rss-feed-to-publish-news-of-updates/1903 "2018-07-06T13:03:22Z")

</div>

Hi there, Are there any plans on producing some form of RSS feed where changes could get published to? The only way at present I can see to detect whether changes have occurred is to download a bulk file and process lo…

---

## [Salesforce struggles with no password for HTTP Basic Authentication](http://forum.companieshouse.gov.uk/t/salesforce-struggles-with-no-password-for-http-basic-authentication/1882)

<div class="topic-metadata">

**Author:** [@charliemciver](http://forum.companieshouse.gov.uk/u/charliemciver)\
**Replies:** 0\
**Last updated:** [June 23, 2018, 1:07pm UTC](http://forum.companieshouse.gov.uk/t/salesforce-struggles-with-no-password-for-http-basic-authentication/1882 "2018-06-23T13:07:02Z")

</div>

The API Basic authentication requires no password (seperate issue logged because documentation erroneously says it ignores the password). I’m using Salesforce - its platform method for creating and securing the call-out…
