Hello,
We are looking into APIs provided by Companies House and have a query regarding GET /company/{company_number}/persons-with-significant-control request.
Would it be possible to get a few either real or mockup responses for this request? Before we register and test API directly, it would be useful for us to look over a few of the response examples in addition to having
the list resource specification. Would you be able to provide examples where:
- Entity is owned directly by individual beneficial owner
- Entity is owned by 1 or more intermediary entities which are then owned by individual beneficial owners
- Entity is owned directly by individual beneficial owner and owned by 1 or more intermediary entities which are then owned by individual beneficial owners
Does the API only return one layer of ownership (and it would be on the user to make iterative calls) or does it return all layers of ownership until the ultimate beneficial ownership (UBO) is reached?
Ie. if I look at company 11201576 in the website, the People>PSC only shows 6958119 entity, however, if I open 6958119, then I can see that it is owned by 6959146 which in turn is owned by a natural person. Would the API call return 11201576 > 6958119 > 6959146 > UBO in a response or would it only return 11201576 > 6958119?
Alternatively, is there another API that could return the sequence of ownership in a single call?
Thank you and have a great week ahead.