Shareholder information

API Question
1

Hi
I want to get shareholder information through API. can you please guide me about it. how to get shareholder details of a company using API.

Thanks

2

Use the following API
https://api.companieshouse.gov.uk/company/registration-number/persons-with-significant-control

Put the actual registraion numer of the company in url.

Check the “natures_of_control” attribute in response.

3

Thanks for reply
let me more clear view to you .
I like to get all details related to shareholder. like i want to fetch how to many share capital in company and which shareholder has how many share and shareholder details.

thanks

4

Looking at https://developer-specs.company-information.service.gov.uk I don’t think that level of detail is available through the APIs.

5

it has been so many month it any update about it.
And any future plan for available for these api.

6

Check out the companies register endpoint Companies House Public Data API: Registers

Read the spec and check out the links in the spec to see if they contain the data you are looking for

7

Dear Phillip,

We check the response of the given API and it is not reflecting us shareholder and share capital information. Can you please help us where we can get the shareholder and share capital information.

Furthermore, Is there a way we can get the CS01 Information via API.

Thanks,
Dinesh Singh

8

I don’t think you can get either of these directly through the API. You’d have to download the CS01 yourself and somehow extract the information from the PDF.

There are some third party (usual paid) services that collate this data from a variety of sources and offer this sort of financial information, but in my experience they don’t tend to be particularly accurate or up to date.

My take is that monitoring these sort of financial aspects of a company aren’t really in Companies House’s purview (more of a Treasury/HMRC thing) and they’re more interested in this information in terms of the structure of the company and record-keeping than the data itself. But that’s me speculating!

9

You can get all the filed docs including CS01 - with this call GET https://api.company-information.service.gov.uk/company/{company number}/filing-history?category=confirmation-statement

You would need to iterate through the docs find (take the latest CS01 by date, use the links.document_metadata url to get tyhe meta data which will then give you the link to the file, from here use the links.document to get the file and download the file, then extract the information from the Pdf )

Each of the calls need to be carried out using your API Key to Collect the data.

Step 1: https://api.company-information.service.gov.uk/company/{company number}/filing-history?category=confirmation-statement

Step 2: Use the url supplied from Step 1 in links.document_metadata for the most recent date and type of CS01

Step 3 Use the url Supplied in Step 2 found in links.document

Step 4 Parse the Document (normally PDF) supplied from Step 3

Not a straightforward call but it can be done.

10

Bill wrote a good answer. To add to that , this is quite in involved task. It is something i am working on adding to convert-ixbrl.co.uk , adding the shareholder info as an additional piece of information along with company accounts json that the api returns (or what the web portal shows)

A- CS01 doesn’t always have share holder information. Sometimes the information is only found in the original company reg memorandum. This means checking the filing history of each company, all the way back to its creation to analyse the share holder changes. In additiona to that , sometimes companies submit ‘confirmation statement with shareholder information’ which contains this info.
B- For many companies , the memorandum is a PDF. Some of these pdfs require OCR making the task more complex
C-If the number of companies that you need is large, there is then the challenge of the api limits. For a few hundred or perhaps even a few thousand companies you might be able to work through the filing history within a reasonable time, without going over your call threshold.
D- You would need to put a process in place to keep this information up to date obviously, so that’s a whole data pipeline right there.

If you come up with a novel way to do this, please do share it here :slight_smile: