Create Beneficial Owner

POST

/v1/businesses/{Business-ID}/beneficial-owners

The endpoint allows to create a new Beneficial Owner.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

New Beneficial Owner has been created

Body

🟠401

🟠403

🟠422

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://test.whitelabel.bitpanda.com/v1/businesses//beneficial-owners' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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": {
        "country": "AT",
        "street": "123 Main Street",
        "city": "Vienna",
        "zip_code": "10001"
    },
    "identification_document": {
        "type": "id_card",
        "number": "AB123456",
        "issuing_country": "AT",
        "issuing_authority": "AT Government",
        "expiration_date": "2030-12-31",
        "mrz_code": "P<UTOERIKSSON<<ANNA<MARIA<<<<<<<<<<<<<<<<<<<L898902C<3UTO6908061F9406236ZE184226B<<<<<14"
    },
    "beneficial_owner_type": "ownership",
    "beneficial_owner_controlling_person_type": "legal-person-ownership",
    "tax_identification_numbers": [
        {
            "id": "12345678",
            "residence": "AT"
        }
    ]
}'

Response Example

201 - Example 1

{
    "data": {
        "id": "77606486-8ce8-11ee-bcac-bfa9d1985705"
    }
}

Delete Shareholder

Get a list of Beneficial Owners