Create Shareholder

The endpoint allows to create a new Shareholder.

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

Business-ID

Request Body schema: application/json

Request details

legal_name
required
string

Legal Name

person_type
required
string

Person type

Enum: "legal_person" "natural_person"
birth_date
required
string

Birth date in YYYY-MM-DD format

residence
required
string

Residence country in ISO 3166-1 alpha-2

direct_ownership_percentage
required
number <float>

Direct ownership percentage

Responses
201

New Shareholder has been created

401

Unauthorized

403

Forbidden

422

Error

500

Internal Error

503

Maintenance or Service unavailable

post/v1/businesses/{Business-ID}/shareholders
Request samples
application/json
{
  • "legal_name": "John Smith",
  • "person_type": "legal_person",
  • "birth_date": "1990-12-31",
  • "residence": "AT",
  • "direct_ownership_percentage": 0.51
}
Response samples
application/json
{
  • "data": {
    }
}