Create Beneficial Owner

The endpoint allows to create a new Beneficial Owner.

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

Business-ID

Request Body schema: application/json

Request details

ownership_percentage
required
number <float>

Ownership percentage (numeric value between 0 and 1)

first_name
required
string

First name

last_name
required
string

Last name

citizenship
required
string

Citizenship country code in ISO 3166-1 alpha-2

birth_date
required
string

Birth date in YYYY-MM-DD format

place_of_birth
string

Place of birth

ext_pep_status
string

External PEP status

required
object
object
beneficial_owner_type
string

Beneficial owner type

Enum: "ownership" "control"
Responses
201

New Beneficial Owner has been created

401

Unauthorized

403

Forbidden

422

Error

500

Internal Error

503

Maintenance or Service unavailable

post/v1/businesses/{Business-ID}/beneficial-owners
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": {
    }
}