Update Beneficial Owner

The endpoint allows to update an existing Beneficial Owner.

SecuritybearerAuth
Request
path Parameters
Business-ID
required
string <uuid>

Business-ID

Beneficial-Owner-ID
required
string <uuid>

Beneficial-Owner-ID

Request Body schema: application/json

Request details

ownership_percentage
number <float>

Ownership percentage (numeric value between 0 and 1)

first_name
string

First name

last_name
string

Last name

citizenship
string

Citizenship country code in ISO 3166-1 alpha-2

birth_date
string

Birth date in YYYY-MM-DD format

place_of_birth
string

Place of birth

ext_pep_status
string

External PEP status

object
object
beneficial_owner_type
string

Beneficial owner type

Enum: "ownership" "control"
Responses
200

The Beneficial Owner has been updated

401

Unauthorized

403

Forbidden

404

Not found

422

Error

500

Internal Error

503

Maintenance or Service unavailable

patch/v1/businesses/{Business-ID}/beneficial-owners/{Beneficial-Owner-ID}
Request samples
application/json
{
  • "ownership_percentage": "0.75",
  • "first_name": "John",
  • "last_name": "Doe",
  • "citizenship": "AT",
  • "birth_date": "1990-12-31",
  • "place_of_birth": "Barcelona",
  • "ext_pep_status": "Not PEP",
  • "address": {
    },
  • "identification_document": {
    },
  • "beneficial_owner_type": "ownership"
}
Response samples
application/json
{
  • "data": {
    }
}