Declare additional owners

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:

hasAdditionalOwnersNeeds
trueAt least one beneficial owner.
falseNo beneficial owners.

If the control person owns 100% of the company, 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

StatusMeaning
401The API key is missing, malformed or expired.
404No company with this ID belongs to your partner account.
409The onboarding is no longer a DRAFT, or the contract has been signed.
422hasAdditionalOwners is missing.
Path Params
integer
required

The company's ID, as returned when the company was created.

Body Params
boolean
required

true if one or more other people or entities own 25% or more of the company, false if not.

Responses
200

The declaration was saved. The response body is empty.

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json