Update a UBO

PUT /v2.01/{ClientId}/users/{UserId}/kyc/ubodeclarations/{UboDeclarationId}/ubos/{UboId}

REST

{
    "FirstName": "AcceptUBO",
    "LastName": "Effertz",
    "Birthday": 652117514,
    "Nationality": "FR",
    "Address": {
        "AddressLine1": "804 Hane Mountains",
        "AddressLine2": "Adriel Overpass",
        "City": "Paris",
        "Region": "Île-de-France",
        "PostalCode": "75001",
        "Country": "FR"
    },
    "Birthplace": {
        "City": "Paris",
        "Country": "FR"
    }
}  

200

{
    "Id": "ubo_m_01JH7TS5ZHW3R501ACJEKD5G39",
    "CreationDate": 1736503498,
    "LastName": "Wiza",
    "FirstName": "Jess",
    "Birthday": 652117514,
    "Nationality": "FR",
    "Address": {
        "AddressLine1": "669 Ratke Forge",
        "AddressLine2": "Schamberger Walk",
        "City": "Paris",
        "Region": "Île-de-France",
        "PostalCode": "75001",
        "Country": "FR"
    },
    "Birthplace": {
        "City": "Paris",
        "Country": "FR"
    },
    "IsActive": true
}  

Read more about the UBO object →

Path parameters

UboDeclarationId · string · required

The unique identifier of the UBO Declaration.

UboId · string · required

The unique identifier of the UBO.

Body parameters

LastName · string

Max. length: 100 characters

The last name of the beneficial owner.

FirstName · string

Max. length: 100 characters

The first name of the beneficial owner.

Birthday · Unix timestamp

The date of birth of the beneficial owner.

Note: This is a Unix timestamp in UTC. Ensure you convert your timezone to UTC to avoid midnight being interpreted as the day before.

Nationality · string

Format: Two-letter country code (ISO 3166-1 alpha-2 format)

The nationality of the beneficial owner.

Address · object

The postal address of the beneficial owner.

Show properties

AddressLine1 · string · required

Max. length: 255 characters

The first line of the address.

AddressLine2 · string

Max. length: 255 characters

The second line of the address.

City · string · required

Max. length: 255 characters

The city of the address.

Region · string

Max. length: 255 characters

Required if Country is US, CA, or MX.

The region of the address.

PostalCode · string · required

Max. length: 255 characters

The postal code of the address. The postal code can contain the following characters: alphanumeric, dashes, and spaces.

Country · string · required

Format: Two-letter country code (ISO 3166-1 alpha-2 format)

The country of the address.

Birthplace · object

Information about the beneficial owner’s place of birth.

Show properties

City · string · required

The city in which the beneficial owner was born.

Country · string · required

Format: Two-letter country code (ISO 3166-1 alpha-2 format)

The country in which the beneficial owner was born.

IsActive · boolean

Whether or not the UBO is considered in the declaration. To disregard a UBO, set this parameter to false. This action is irreversible.

Responses

200

Id · string

Max length: 128 characters (see data formats for details)

The unique identifier of the object.

CreationDate · Unix timestamp

The date and time at which the object was created.

LastName · string

Max. length: 100 characters

The last name of the beneficial owner.

FirstName · string

Max. length: 100 characters

The first name of the beneficial owner.

Birthday · Unix timestamp

The date of birth of the beneficial owner.

Note: This is a Unix timestamp in UTC. Ensure you convert your timezone to UTC to avoid midnight being interpreted as the day before.

Nationality · string

The nationality of the beneficial owner.

Address · object

The postal address of the beneficial owner.

Show properties

AddressLine1 · string

Max. length: 255 characters

The first line of the address.

AddressLine2 · string

Max. length: 255 characters

The second line of the address.

City · string

Max. length: 255 characters

The city of the address.

Region · string

Max. length: 255 characters

The region of the address. This field is optional except if the Country is US, CA, or MX.

PostalCode · string

Max. length: 255 characters

The postal code of the address. The postal code can contain the following characters: alphanumeric, dashes, and spaces.

Country · string

Format: Two-letter country code (ISO 3166-1 alpha-2 format)

The country of the address.

Birthplace · object

Information about the beneficial owner’s place of birth.

Show properties

City · string

The city in which the beneficial owner was born.

Country · string

Format: Two-letter country code (ISO 3166-1 alpha-2 format)

The country in which the beneficial owner was born.

IsActive · boolean

Whether or not the UBO is considered in the declaration. To disregard a UBO, this parameter must be set to false. This action is irreversible.

400 - Deactivated UBO can't be reactivated or modified

{
    "Message": "You can not update an UBO that is inactive",
    "Type": "invalid_action",
    "Id": "583a9b71-c820-46ea-805d-f6152746bcc6#1736503621",
    "Date": 1736503622,
    "errors": null
}

200

{
    "Id": "ubo_m_01JH7TS5ZHW3R501ACJEKD5G39",
    "CreationDate": 1736503498,
    "LastName": "Wiza",
    "FirstName": "Jess",
    "Birthday": 652117514,
    "Nationality": "FR",
    "Address": {
        "AddressLine1": "669 Ratke Forge",
        "AddressLine2": "Schamberger Walk",
        "City": "Paris",
        "Region": "Île-de-France",
        "PostalCode": "75001",
        "Country": "FR"
    },
    "Birthplace": {
        "City": "Paris",
        "Country": "FR"
    },
    "IsActive": true
}  

REST

{
    "FirstName": "AcceptUBO",
    "LastName": "Effertz",
    "Birthday": 652117514,
    "Nationality": "FR",
    "Address": {
        "AddressLine1": "804 Hane Mountains",
        "AddressLine2": "Adriel Overpass",
        "City": "Paris",
        "Region": "Île-de-France",
        "PostalCode": "75001",
        "Country": "FR"
    },
    "Birthplace": {
        "City": "Paris",
        "Country": "FR"
    }
}