# Documentation Issues **URL:** http://forum.companieshouse.gov.uk/c/documentation-issues/19.md [Latest](http://forum.companieshouse.gov.uk/latest.md) · [Categories](http://forum.companieshouse.gov.uk/categories.md) --- ## [About the Documentation Issues category](http://forum.companieshouse.gov.uk/t/about-the-documentation-issues-category/910)
**Author:** [@mfairhurst](http://forum.companieshouse.gov.uk/u/mfairhurst)\ **Replies:** 0
The Documentation Issues category should be used to report issues with the API documentation found at http://developer.companieshouse.gov.uk --- ## [Prod198 Run Frequency Query](http://forum.companieshouse.gov.uk/t/prod198-run-frequency-query/13041)
**Author:** [@dawn.barnaby](http://forum.companieshouse.gov.uk/u/dawn.barnaby)\ **Replies:** 0\ **Last updated:** [September 30, 2026, 12:48pm UTC](http://forum.companieshouse.gov.uk/t/prod198-run-frequency-query/13041 "2026-09-30T12:48:10Z")
The documentation suggests Prod198 is run daily. However, it seems to be that it is not run on Sundays or Mondays looking at the last month in the SFTP. Can you please confirm? --- ## [Prod 195 Snapshot Trailer Count](http://forum.companieshouse.gov.uk/t/prod-195-snapshot-trailer-count/13040)
**Author:** [@dawn.barnaby](http://forum.companieshouse.gov.uk/u/dawn.barnaby)\ **Replies:** 0\ **Last updated:** [September 30, 2026, 12:47pm UTC](http://forum.companieshouse.gov.uk/t/prod-195-snapshot-trailer-count/13040 "2026-09-30T12:47:29Z")
The documentation for the Officers Snapshot file (Prod 195) suggests that the trailer count doesn’t include header or trailer records. However, by excluding these before counting, I am consistently getting counts of reco… --- ## [Prod - 199 - data access](http://forum.companieshouse.gov.uk/t/prod-199-data-access/12766)
**Author:** [@jonathan.white](http://forum.companieshouse.gov.uk/u/jonathan.white)\ **Replies:** 0\ **Last updated:** [May 1, 2026, 7:10am UTC](http://forum.companieshouse.gov.uk/t/prod-199-data-access/12766 "2026-05-01T07:10:02Z")
I am trying to access the mortgage data contained in Prod 199. Please can someone kindly share further details on how to go about access this data. --- ## [Missing documentation to submit company account](http://forum.companieshouse.gov.uk/t/missing-documentation-to-submit-company-account/11997)
**Author:** [@coderforge](http://forum.companieshouse.gov.uk/u/coderforge)\ **Replies:** 1\ **Last updated:** [January 27, 2026, 1:11pm UTC](http://forum.companieshouse.gov.uk/t/missing-documentation-to-submit-company-account/11997 "2026-01-27T13:11:49Z")
Missing documentation to submit company account. Have you a link? --- ## [XML or API for filing accounts?](http://forum.companieshouse.gov.uk/t/xml-or-api-for-filing-accounts/11332)
**Author:** [@companieshouse-fcl8q](http://forum.companieshouse.gov.uk/u/companieshouse-fcl8q)\ **Replies:** 1\ **Last updated:** [January 27, 2026, 1:08pm UTC](http://forum.companieshouse.gov.uk/t/xml-or-api-for-filing-accounts/11332 "2026-01-27T13:08:54Z")
The Information for Developers document says the XML platform is planned to be replaced by a (REST JSON) API in the long-term future. Webfiling is ending next year. I am a micro business managing everything myself. Th… --- ## [PSC Streaming specification incorrect - resource\_kind](http://forum.companieshouse.gov.uk/t/psc-streaming-specification-incorrect-resource-kind/12340)
**Author:** [@steven.houston](http://forum.companieshouse.gov.uk/u/steven.houston)\ **Replies:** 2\ **Last updated:** [November 4, 2025, 9:39am UTC](http://forum.companieshouse.gov.uk/t/psc-streaming-specification-incorrect-resource-kind/12340 "2025-11-04T09:39:53Z")
Hello, I’ve been looking at the documentation for the PSC streaming API and I think I’ve noticed an error with it. For the resource\_kind it shows the possible values as the following which don’t appear to tally up: I… --- ## [BULK Product - Import txt in Excel](http://forum.companieshouse.gov.uk/t/bulk-product-import-txt-in-excel/12327)
**Author:** [@sujahat.alikhan](http://forum.companieshouse.gov.uk/u/sujahat.alikhan)\ **Replies:** 1\ **Last updated:** [November 2, 2025, 7:49am UTC](http://forum.companieshouse.gov.uk/t/bulk-product-import-txt-in-excel/12327 "2025-11-02T07:49:29Z")
Im not able to import the .txt correctly in excel to have any meaningful data as its all jumbled. Can anyone suggest what I am doing wrong? --- ## [API versioning behaviour](http://forum.companieshouse.gov.uk/t/api-versioning-behaviour/12306)
**Author:** [@alastairs](http://forum.companieshouse.gov.uk/u/alastairs)\ **Replies:** 1\ **Last updated:** [October 28, 2025, 9:43am UTC](http://forum.companieshouse.gov.uk/t/api-versioning-behaviour/12306 "2025-10-28T09:43:10Z")
Hi, I’m working on integrating the Companies House Public Data API for an application. At the moment I understand the API versioning documentation to be one of: Proposed but never implemented. Implemented but the doc… --- ## [Ew, wa, sc, ni, r, oc, so, nc?](http://forum.companieshouse.gov.uk/t/ew-wa-sc-ni-r-oc-so-nc/12096)
**Author:** [@abercorn1](http://forum.companieshouse.gov.uk/u/abercorn1)\ **Replies:** 3\ **Last updated:** [September 12, 2025, 12:02pm UTC](http://forum.companieshouse.gov.uk/t/ew-wa-sc-ni-r-oc-so-nc/12096 "2025-09-12T12:02:56Z")
What do EW, WA, SC, NI, R, OC, SO, NC mean ?? They are in FormSubmission-v2-11.xsd Some appear obvious, but its not professional to make a guess. So what do the refer to, and more to the point where are they define… --- ## [Open API Specifications broken links](http://forum.companieshouse.gov.uk/t/open-api-specifications-broken-links/7663)
**Author:** [@alaa.al-jarrah](http://forum.companieshouse.gov.uk/u/alaa.al-jarrah)\ **Replies:** 3\ **Last updated:** [June 19, 2025, 12:35pm UTC](http://forum.companieshouse.gov.uk/t/open-api-specifications-broken-links/7663 "2025-06-19T12:35:14Z")
Hi, Im trying to download the API specifications for Companies House Public Data API, the swagger file has many references for 127.0.0.1:10000, I replaced those with developer-specs.company-information.service.gov.uk and… --- ## [Rate limits - streaming endpoints](http://forum.companieshouse.gov.uk/t/rate-limits-streaming-endpoints/11609)
**Author:** [@phillip](http://forum.companieshouse.gov.uk/u/phillip)\ **Replies:** 2\ **Last updated:** [June 4, 2025, 6:52am UTC](http://forum.companieshouse.gov.uk/t/rate-limits-streaming-endpoints/11609 "2025-06-04T06:52:55Z")
I have been consuming the streaming API and have been using a single app to connect to 6 streams without issue. However, I added another 2 endpoint (the disqualified officers and PSC-Statements) making the total 8 and I … --- ## [Prod 101 - Documentation for Gazettable Document Type](http://forum.companieshouse.gov.uk/t/prod-101-documentation-for-gazettable-document-type/10562)
**Author:** [@StuC](http://forum.companieshouse.gov.uk/u/StuC)\ **Replies:** 1\ **Last updated:** [June 3, 2025, 2:24pm UTC](http://forum.companieshouse.gov.uk/t/prod-101-documentation-for-gazettable-document-type/10562 "2025-06-03T14:24:32Z")
Hi, I’m a consumer of the bulk product and the Customer Care team have directed me here to raise my issue. We requested a Spec Document to give meaning for the code values used within Gazettable Document Type On revie… --- ## [GET charges response type documented incorrectly](http://forum.companieshouse.gov.uk/t/get-charges-response-type-documented-incorrectly/10565)
**Author:** [@jan.tucholka](http://forum.companieshouse.gov.uk/u/jan.tucholka)\ **Replies:** 0\ **Last updated:** [December 20, 2024, 2:53pm UTC](http://forum.companieshouse.gov.uk/t/get-charges-response-type-documented-incorrectly/10565 "2024-12-20T14:53:32Z")
Hello, I’d like to report the following misalignments I observed between the implementation of the Companies House API and its documentation : /company/{companyNumber}/charges endpoint returns items\[ \].classificatio… --- ## [OAuth2 Authentication](http://forum.companieshouse.gov.uk/t/oauth2-authentication/8362)
**Author:** [@ashrittha.narra1](http://forum.companieshouse.gov.uk/u/ashrittha.narra1)\ **Replies:** 0\ **Last updated:** [August 23, 2024, 11:47am UTC](http://forum.companieshouse.gov.uk/t/oauth2-authentication/8362 "2024-08-23T11:47:16Z")
Can anyone let me know what is the Refresh Token validity ? --- ## [Open API specification points to 127.0.0.1](http://forum.companieshouse.gov.uk/t/open-api-specification-points-to-127-0-0-1/8157)
**Author:** [@p.zajdler](http://forum.companieshouse.gov.uk/u/p.zajdler)\ **Replies:** 2\ **Last updated:** [July 8, 2024, 6:55am UTC](http://forum.companieshouse.gov.uk/t/open-api-specification-points-to-127-0-0-1/8157 "2024-07-08T06:55:30Z")
Hi, I’m looking to generate models based on the Open API spec that (only theoretically) can be downloaded from the docs. Unfortunately, upon inspecting the Open API spec file (https://developer-specs.company-informatio… --- ## [API Rate Limit increase](http://forum.companieshouse.gov.uk/t/api-rate-limit-increase/1415)
**Author:** [@dave1](http://forum.companieshouse.gov.uk/u/dave1)\ **Replies:** 11\ **Last updated:** [June 17, 2024, 3:12pm UTC](http://forum.companieshouse.gov.uk/t/api-rate-limit-increase/1415 "2024-06-17T15:12:31Z")
Hi, There’s a page in the documentation about the rate limit and how users should get in touch if they want to increase it. It would probably be worth adding a contact email address to that page so we don’t have to clog… --- ## [Is there any SAST / Veracode report for the APIs?](http://forum.companieshouse.gov.uk/t/is-there-any-sast-veracode-report-for-the-apis/8021)
**Author:** [@ashrittha.narra1](http://forum.companieshouse.gov.uk/u/ashrittha.narra1)\ **Replies:** 0\ **Last updated:** [June 5, 2024, 8:56pm UTC](http://forum.companieshouse.gov.uk/t/is-there-any-sast-veracode-report-for-the-apis/8021 "2024-06-05T20:56:12Z")
No SAST and veracode report is available. any information provided can be useful. --- ## [Full list of parameters](http://forum.companieshouse.gov.uk/t/full-list-of-parameters/7987)
**Author:** [@shruti.sood](http://forum.companieshouse.gov.uk/u/shruti.sood)\ **Replies:** 1\ **Last updated:** [May 27, 2024, 10:23am UTC](http://forum.companieshouse.gov.uk/t/full-list-of-parameters/7987 "2024-05-27T10:23:58Z")
Where can I find the full list of parameters available in the API? Is there any documentation around this? --- ## [OpenAPI Schema has invalid URLs](http://forum.companieshouse.gov.uk/t/openapi-schema-has-invalid-urls/5818)
**Author:** [@jhill8786](http://forum.companieshouse.gov.uk/u/jhill8786)\ **Replies:** 3\ **Last updated:** [March 27, 2024, 12:33pm UTC](http://forum.companieshouse.gov.uk/t/openapi-schema-has-invalid-urls/5818 "2024-03-27T12:33:03Z")
I’m trying to get a handle on the Companies House API response schema, so I had a look at the OpenAPI spec. It seems, however, that each endpoint has an invalid URL to the sub schema. See below for an example: https://… --- ## [Incorrect list of filing event categories for streaming API](http://forum.companieshouse.gov.uk/t/incorrect-list-of-filing-event-categories-for-streaming-api/7373)
**Author:** [@jacques](http://forum.companieshouse.gov.uk/u/jacques)\ **Replies:** 0\ **Last updated:** [January 25, 2024, 1:25pm UTC](http://forum.companieshouse.gov.uk/t/incorrect-list-of-filing-event-categories-for-streaming-api/7373 "2024-01-25T13:25:58Z")
The categories of the documents filed here seems to be out of date: https://developer-specs.company-information.service.gov.uk/streaming-api/resources/filinghistorystream?v=latest Is it possible to provide an exhasutive… --- ## [Search Companies API - missing documentation for restrictions enumeration](http://forum.companieshouse.gov.uk/t/search-companies-api-missing-documentation-for-restrictions-enumeration/7371)
**Author:** [@infrastructure](http://forum.companieshouse.gov.uk/u/infrastructure)\ **Replies:** 0\ **Last updated:** [January 25, 2024, 12:10pm UTC](http://forum.companieshouse.gov.uk/t/search-companies-api-missing-documentation-for-restrictions-enumeration/7371 "2024-01-25T12:10:59Z")
We are using your companies search API. https://developer-specs.company-information.service.gov.uk/companies-house-public-data-api/reference/search/search-companies The ‘restrictions’ enumeration does not seem document… --- ## [How to get auditor or accountant info](http://forum.companieshouse.gov.uk/t/how-to-get-auditor-or-accountant-info/7316)
**Author:** [@rubenportz](http://forum.companieshouse.gov.uk/u/rubenportz)\ **Replies:** 2\ **Last updated:** [January 19, 2024, 8:04am UTC](http://forum.companieshouse.gov.uk/t/how-to-get-auditor-or-accountant-info/7316 "2024-01-19T08:04:47Z")
Questions: Is there a way to extract the auditor’s organisation name when a filing is done by an external auditor, accountant or tax advisor? Context: I noticed companies like Beauhurst and RedFlagAlert presenting audit… --- ## [Section 790ZF exemption for electronic PSC04 submission](http://forum.companieshouse.gov.uk/t/section-790zf-exemption-for-electronic-psc04-submission/6773)
**Author:** [@pedro](http://forum.companieshouse.gov.uk/u/pedro)\ **Replies:** 0\ **Last updated:** [August 30, 2023, 2:47pm UTC](http://forum.companieshouse.gov.uk/t/section-790zf-exemption-for-electronic-psc04-submission/6773 "2023-08-30T14:47:33Z")
Would it be possible to enable section\_790zf in the PSC change details section like paper form (PSC04)? https://xmlgw.companieshouse.gov.uk/v1-0/schema/PSCBaseTypes-v1-3.xsd XML failed schema validation: Invalid XML:… --- ## [Changes to API object - PSC (list) resource - name elements](http://forum.companieshouse.gov.uk/t/changes-to-api-object-psc-list-resource-name-elements/2021)
**Author:** [@voracityemail](http://forum.companieshouse.gov.uk/u/voracityemail)\ **Replies:** 2\ **Last updated:** [March 24, 2023, 11:33am UTC](http://forum.companieshouse.gov.uk/t/changes-to-api-object-psc-list-resource-name-elements/2021 "2023-03-24T11:33:53Z")
PSC list / individual - the “name\_elements” object “other\_forenames” field has changed to “middle\_name”. This probably changed ages back but just noticed it. Documentation still shows the “other\_forenames” field so one… --- ## [API GET Company profile endpoint discrepancy](http://forum.companieshouse.gov.uk/t/api-get-company-profile-endpoint-discrepancy/5442)
**Author:** [@rhys](http://forum.companieshouse.gov.uk/u/rhys)\ **Replies:** 3\ **Last updated:** [September 7, 2022, 4:01pm UTC](http://forum.companieshouse.gov.uk/t/api-get-company-profile-endpoint-discrepancy/5442 "2022-09-07T16:01:33Z")
I make use of the GET https://api.company-information.service.gov.uk/company/{companyNumber} endpoint of your API. I’m relying on the accounts.next\_accounts property that is returned in the response from the endpoint, bu… --- ## [Specification not available](http://forum.companieshouse.gov.uk/t/specification-not-available/4431)
**Author:** [@ollie](http://forum.companieshouse.gov.uk/u/ollie)\ **Replies:** 9\ **Last updated:** [December 7, 2021, 1:56pm UTC](http://forum.companieshouse.gov.uk/t/specification-not-available/4431 "2021-12-07T13:56:18Z")
None of the specification is currently available from the getting started page: https://developer-specs.company-information.service.gov.uk/ 504 Gateway Time-out https://developer.company-information.service.gov.uk/api/… --- ## [Document description\_values for Filings API call](http://forum.companieshouse.gov.uk/t/document-description-values-for-filings-api-call/4256)
**Author:** [@cos\_marginean](http://forum.companieshouse.gov.uk/u/cos_marginean)\ **Replies:** 2\ **Last updated:** [August 11, 2021, 7:05pm UTC](http://forum.companieshouse.gov.uk/t/document-description-values-for-filings-api-call/4256 "2021-08-11T19:05:49Z")
The documentation here doesn’t provide much in the way of discussing the description\_values field which seems to be returned as a result of this call. This is clearly crucial for producing the content in the filings pre… --- ## [Broken link on "getting started" page](http://forum.companieshouse.gov.uk/t/broken-link-on-getting-started-page/3803)
**Author:** [@deant](http://forum.companieshouse.gov.uk/u/deant)\ **Replies:** 0\ **Last updated:** [April 10, 2021, 5:26pm UTC](http://forum.companieshouse.gov.uk/t/broken-link-on-getting-started-page/3803 "2021-04-10T17:26:40Z")
Hey! Just getting started with the API. Broken link on this page in the “overview” section: https://developer-specs.company-information.service.gov.uk/guides/gettingStarted In fact, could that section just be removed… --- ## [Broken OpenAPI Specification for Public Data API](http://forum.companieshouse.gov.uk/t/broken-openapi-specification-for-public-data-api/3796)
**Author:** [@nolandsmith1](http://forum.companieshouse.gov.uk/u/nolandsmith1)\ **Replies:** 0\ **Last updated:** [April 9, 2021, 7:29pm UTC](http://forum.companieshouse.gov.uk/t/broken-openapi-specification-for-public-data-api/3796 "2021-04-09T19:29:06Z")
The JSON for the OpenAPI Specification under the Companies House Public Data API appears to be incorrect. All the paths are returning errors There is a duplicate tag for “Officers” [Next page](http://forum.companieshouse.gov.uk/c/documentation-issues/19.md?page=1)