Unfortunately you may have some work to do.
At least as far as the API goes all the fields in the corporate entity beneficial owner object are marked “optional” in the documentation. I haven’t checked through exactly what you are required to register but the normal way of things with Companies House is you might get in trouble if you don’t submit a form. However there is almost no checking and validation of the contents of any form. Indeed I believe by law Companies House are bound to record things but not to police them!
So a) you may find that information has not been supplied, and b) in general there is no validation in the dataset for most fields. Certainly this seems to be the case for some other country fields. So it’s possible that you will find someone has written “BVI”, “Virgin Islands, British”, “islands; BRITISH; virgin” or indeed anything at all … Again for most fields I’m not aware that Companies House will do anything other than record what has been submitted in their databases.
I would get hold of the bulk data and just see what’s there. Or issue some test queries and see what you get back.
We deal with this by attempting to parse address / country / nationality text into something standard - if that’s possible.
Some of this difficulty presumably is the need to cope with a dataset which spans over 100 years. Many current countries didn’t exist then. Additionally countries have changed shape and some have come and gone!
There is a list of countries for company filings - I assume that is the “preferred” list. This is at:
Also of foreign registries here:
Hope this helps.
