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).
Language
Credentials
Response
Click Try It! to start a request and see the response here!