Filing History Categories fill list

API Question
#1

Hi All

Looking through your API documentation and you Github repository, I could not see a full list of the types of Account Categories and the Account types

Currently, we can see this initial list of Categories

accounts
address
annual-return
capital
change-of-name
incorporation
liquidation
miscellaneous
mortgage
officers
resolution
However, when we are looking at the data we can see some other categories that are not listed.

auditors
confirmation-statement

I was wondering if possible if you would provide me with a list of Account Categories and the Account types that are possible from Companies House.

I see the following post: Filing History Categories that you were working on this. What is the status of this?

I’m looking forward to your response.

Thanks

Chris

#2

I don’t like to bump an old thread but found this when searching for an answer. The documentation here hasn’t been updated with the confirmation-statement category yet and we’d just like to know if there are any other categories we’re missing (like the auditors one above).

Has anyone got an update on this?

#3

@MArkWilliams I don’t suppose you’d be able to respond to this thread? In the past I’ve seen the categories “confirmation-statement”, “gazette”, “historical”, “insolvency” and “restoration” in API responses but none of which appear in the filing history docs.
Likewise if the full mapping of form type to category (as previously asked for in this post) is available, would you me able to point me in the right direction or send it over?
Thanks!

#4

I am looking at this today.

1 Like
#5

Here are the categories and sub-categories:-
category: accounts
category: address
category: annual-return
category: auditors
category: capital
category: certificate
category: change-of-constitution
category: change-of-name
category: confirmation-statement
category: court-order
category: dissolution
category: document-replacement
category: gazette
category: historical
category: incorporation
category: insolvency
category: liquidation
category: mortgage
category: officers
category: other
category: persons-with-significant-control
category: reregistration
category: resolution
category: restoration
category: social-landlord
subcategory: acquire
subcategory: administration
subcategory: alter
subcategory: annual-return
subcategory: appointments
subcategory: certificate
subcategory: change
subcategory: compulsory
subcategory: court-order
subcategory: create
subcategory: debenture
subcategory: document-replacement
subcategory: investment-company
subcategory: mortgage
subcategory: notifications
subcategory: officers
subcategory: other
subcategory: receiver
subcategory: register
subcategory: release-cease
subcategory: resolution
subcategory: satisfy
subcategory: social-landlord
subcategory: statements
subcategory: termination
subcategory: transfer
subcategory: trustee
subcategory: voluntary
subcategory: voluntary-arrangement
subcategory: voluntary-arrangement-moratoria

1 Like
Company Documents
#6

If anyone requires a full list of mappings of documents to categories, I have had the OK to give it out. It does change of course, but I will post notifications on the forum when it does.
Ideally this would be in a public github repository, but there is some work to do before we can publish it.

1 Like
#7

Thanks very much Mark, would you be able to send me over the full list of mappings of documents to categories?

#8

Hi @MArkWilliams , Think there’s also a category called “miscellaneous” which is returned by the following transaction ids/Companies House ids (and plenty of more examples if required):

  • Transaction id: MTA5NzA1NTQzYWRpcXprY3g for Companies House ID: 02180957
  • Transaction id: MTI4MjQ4Nzg0YWRpcXprY3g for Companies House ID: 00486648
  • Transaction id: MTA0MDQyNzk3YWRpcXprY3g for Companies House ID: 00488182
  • Transaction id: MzE5Mjk3ODMyMGFkaXF6a2N4 for Companies House ID: 00598696
  • Transaction id: MzA1MDQyNzkyOWFkaXF6a2N4 for Companies House ID: 00240822

If you have that full list mapping document type to categories that would be really helpful, please let me know how I can get access to that document if it’s not publicly accessible.

#9

The list I gave you came from the code we have checked in.
Looking through the actual data, we do indeed seem to have at least an additional one “miscellaneous”
I will see if I can run a query on the 150 million items to see if we have any more.

#10

The actual values from the current data are:-
accounts
address
annual-return
auditors
capital
certificate
change-of-constitution
change-of-name
confirmation-statement
court-order
dissolution
document-replacement
gazette
historical
incorporation
insolvency
liquidation
miscellaneous
mortgage
officer
officers
other
persons-with-significant-control
reregistration
resolution
restoration
return
social-landlord

1 Like
#11

@MArkWilliams thanks for looking into those, so I presume “miscellaneous”, “officer” and “return” are all deprecated categories?
Will “officer” be merged into “officers” and “return” into “annual-return” at some point in the future or are those categories set and we should assume those are all valid category types?

#12

Yes, so the difference between the code and actual can be presumed deprecated.
There are no plans to merge any categories.