v5

latestOpenAPI 3.1.02026-07-262421791.5 MB
profile

Create business ultimate owners

Adds new ultimate beneficial owners to the business profile.

Returns the list of all ultimate beneficial owners associated with the business profile.

All the shareholders that have at least 25% ownership should be submitted via this API.

Note that in some cases, we do not require the ownershipPercentage. In these cases, null should be passed as the value.

post/v1/profiles/{profileId}/ubos

Path parameters

profileIdinteger required

Business profile ID.

Headers

X-External-Correlation-Idstring uuid

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Request body

namestring

Owner full name.

dateOfBirthstring

Date of birth.

countryOfResidenceIso3Codestring

3 character country code.

addressFirstLinestring

First line of address.

postCodestring

Address post code.

ownershipPercentageinteger nullable

Percentage of ownership.

Example request

[
  {
    "name": "John Doe",
    "dateOfBirth": "1982-05-20",
    "countryOfResidenceIso3Code": "usa",
    "addressFirstLine": "123 Fake St",
    "postCode": "FK 12345",
    "ownershipPercentage": 30
  }
]

Response

List of all ultimate beneficial owners associated with the business profile.

idstring

ID of the ultimate beneficial owner.

namestring

Owner full name.

dateOfBirthstring

Date of birth.

countryOfResidenceIso3Codestring

3 character country code.

addressFirstLinestring

First line of address.

postCodestring

Address post code.

ownershipPercentageinteger nullable

Percentage of ownership.

Example response

[
  {
    "id": "013ab1c2688d0185b582ee7e0bcb28b2",
    "name": "John Doe",
    "dateOfBirth": "1982-05-20",
    "countryOfResidenceIso3Code": "usa",
    "addressFirstLine": "123 Fake St",
    "postCode": "FK 12345",
    "ownershipPercentage": 30
  }
]