delete
https://api.everee.com/integration/v1/partner/companies//beneficial-owners/
Delete a beneficial owner from a draft company.
Use this endpoint to remove a beneficial owner. The response body is empty.
Part of People and ownership. For how this fits into onboarding, see the guide: Collecting company information: the people.
If you remove the last owner while the ownership declaration says there are additional owners, OWNERSHIP_DECLARATION appears in readiness.missing until you add an owner or change the declaration.
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 | The company or the owner wasn't found. |
409 | The onboarding is no longer a DRAFT, or the contract has been signed. |
The owner was deleted. The response body is empty.