Add a person or entity that owns 25% or more of the company.
Use this endpoint to add a beneficial owner: a person or legal entity that owns 25% or more of the company. Add one call per owner.
Part of People and ownership. For how this fits into onboarding, see the guide: Collecting company information: the people.
Owner types
ownerType: PERSON(the default): the person fields andidentitydescribe the owner.ownerType: ENTITY: the owner is a legal entity.entityName,entityEin,representativeOwnershipPercentageand the representative'stitleare all required, and the person fields andidentitydescribe the individual who represents the entity.
ownershipPercentage is from 25 to 100: only owners of 25% or more are added, so leave out anyone who owns less. Together with the control person's percentage and the other owners' it can't exceed 100% (a 400 otherwise), but the total doesn't have to reach 100%.
identity takes either an ssn, or a passportNumber and passportCountry, but not both.
You also need to make an ownership declaration of hasAdditionalOwners: true for the owners to count.
When you can call this
- While the onboarding is a
DRAFTand the contract documents haven't been signed. - While the onboarding is
UNDER_REVIEW, only to answer an openADDITIONAL_PERSON_DETAILSreview request. Pass that request's ID asrequestId. Adding the owner resolves the request, sends the new owner their identity-verification link, and voids the signed contract so that a new signature is requested, with the new owner on the documents.
Otherwise it returns 409.
Errors
| Status | Meaning |
|---|---|
400 | identity is invalid, an ENTITY owner is missing required details, or ownership would total more than 100%. |
401 | The API key is missing, malformed or expired. |
404 | No company with this ID belongs to your partner account. |
409 | The onboarding can no longer be edited this way, or the contract has been signed. |
422 | A required field is missing or malformed, or ownershipPercentage is outside 25 to 100. |