Declare whether the company has beneficial owners besides the control person.
Use this endpoint to declare whether anyone other than the control person owns 25% or more of the company. The response body is empty.
Part of People and ownership. For how this fits into onboarding, see the guide: Collecting company information: the people.
The declaration has to agree with the beneficial owners you add. Until it does, OWNERSHIP_DECLARATION appears in readiness.missing:
hasAdditionalOwners | Needs |
|---|---|
true | At least one beneficial owner. |
false | No beneficial owners. |
Only people and entities that own 25% or more count, and the owners need not add up to 100%: a company can have, say, a 40% control person and a 30% owner, with the rest spread among smaller holders. If the control person owns more than 75%, no one else can own 25%, so no declaration is needed.
When you can call this
Only while the onboarding is a DRAFT and the contract documents haven't been signed. Otherwise it returns 409.
Errors
| Status | Meaning |
|---|---|
401 | The API key is missing, malformed or expired. |
404 | No company with this ID belongs to your partner account. |
409 | The onboarding is no longer a DRAFT, or the contract has been signed. |
422 | hasAdditionalOwners is missing. |
200The declaration was saved. The response body is empty.