SUsumsub

Link beneficiary to company (KYB 1.0)

Changed on
post/resources/applicants/{applicantId}/info/companyInfo/beneficiaries

Request

Path parameters

applicantIdstring required

Unique identifier of the company applicant to whose control and ownership structure you need to add a beneficiary applicant.<br><br>This identifier is a random combination of 24 digits and lowercase Latin characters. It is automatically generated when the applicant profile is created on the Sumsub side, and can be found in the Dashboard. <br><br>If the applicantId is unknown to you, use the Get applicant data (externalUserId) method to fetch it.

Request body

applicantIdstring required

Applicant identifier of the beneficiary to be linked to the company profile.

positionsstring[]
<p>Positions in the company that the beneficiary is holding.<p><ul><li><code>director</code> — appointed to manage the company business and affairs.</li><li><code>shareholder</code> — owns shares in the company stock.</li><li><code>other</code> — specify a position that does not meet the two above.</li></ul><p>Add one position per string.<p>
type'ubo' | 'shareholder' | 'representative' | 'director' required

Beneficiary single role in the company control and ownership structure.<br><br>Possible values:<ul><li><code>ubo</code> — ultimate beneficial owner of the company.</li><li><code>shareholder</code> — owns shares in the company stock.</li><li><code>representative</code> — authorized to act or speak for or in support of the company.</li><li><code>director</code> — appointed to manage the company business and affairs.</li></ul>

Changes