Create UBO (v2)

Creates a new UBO (Ultimate Beneficial Owner) for a specific sender. Note: Document requirements (documentFront, documentBack) vary by country. Please refer to the validation-rules endpoint with ownerType='business' and the specific country to determine exact documentation requirements. Multiple UBOs can be added by calling this endpoint multiple times. The total ownership percentage across all UBOs should not exceed 100%.

Additional v2 details:

  • pepDeclaration is required.
  • verificationReport and verificationReportFileName are supported.
  • The total request payload size must be less than 10 MB.
  • sofDocument is required when any of the following is true:
    • UBO age is less than 25
    • UBO age is greater than 60
    • pepDeclaration is true
    • address.country is one of: DZ, AO, BO, BG, BF, CM, CI, ET, HT, IQ, KE, LA, LB, ML, MC, MZ, NA, NP, NI, NG, SO, SY, VN, VG, YE
    • identity.countryCode is one of: DZ, AO, BO, BG, BF, CM, CI, ET, HT, IQ, KE, LA, LB, ML, MC, MZ, NA, NP, NI, NG, SO, SY, VN, VG, YE
  • pepQuestionnaire is supported. It is required when pepDeclaration is true.
  • pepQuestionnaire.declarationType controls which section is required: self (for SELF) or association (for IMMEDIATE_FAMILY and CLOSE_ASSOCIATE).
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

First name of the UBO.

string
required

Last name of the UBO.

date
required

Birthdate of the UBO in the format YYYY-MM-DD.

string
required

Phone number of the UBO in international format (for example, +11234567890).

string
required

Email address of the UBO.

number
required
0 to 100

Ownership percentage of the UBO in the company.

address
object
required

UBO postal address.

uuid
required

Unique identifier for the sender.

identity
object
required

Identity information for the UBO.

string

Optional base64 encoded verification report document.

string

Optional file name for the verification report.

boolean
required

Whether the UBO is politically exposed. This field is required.

string

Base64 encoded source-of-funds document. Required when the UBO is younger than 25 or older than 60, when pepDeclaration is true, or when either address.country or identity.countryCode is one of: DZ, AO, BO, BG, BF, CM, CI, ET, HT, IQ, KE, LA, LB, ML, MC, MZ, NA, NP, NI, NG, SO, SY, VN, VG, YE.

pepQuestionnaire
object | null

Required when pepDeclaration is true. Contains declarationType with conditional self or association sections.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json