Create Related Party

---

Introduction

This resource aims to identify the final beneficiaries (natural persons) and controllers related to the legal person investor, such as partners, directors, administrators, etc.

Attention

• It is mandatory to create at least one related party
• It is mandatory that at least one related party has legal_representative: true
• For legal person as a related party, the related_party_type must be parent_company
• This endpoint must be called multiple times, once for each related party

About Final Beneficiaries

Final Beneficiary is the natural person who, ultimately, exercises a position of control or significant influence in the company, especially those who hold 15% or more of direct or indirect participation, exercise administrative positions, or represent the company for legal purposes.

Provide data for natural persons who hold 15% or more of direct or indirect equity participation and administrators. If none of the partners/shareholders individually holds participation equal to or greater than 15%, we request sending information for the 03 controllers who hold the largest participation percentages.

Input / Output:

As input, the related party data must be sent.

As output, a related_party_key and the details of the created related party will be delivered.

Request

ENDPOINT

/investor_registry/v2/investor/{investor_key}/investor_analysis/{investor_analysis_key}/related_party

METHOD

POST

STATUS

201

Request body

Example: Natural Person Partner

Request Body

{
    "name": "João Silva",
    "document_number": "123.456.789-00",
    "person_type": "natural_person",
    "related_party_type": "partner",
    "resident": true,
    "legal_representative": true,
    "direct_beneficiary": true,
    "address": {
        "postal_code": "01000-000",
        "street": "Rua das Flores",
        "number": "123",
        "neighborhood": "Centro",
        "city": "São Paulo",
        "uf": "SP",
        "country": "BRA",
        "complement": "Apto 101"
    },
    "participation_percentage": 0.5,
    "monthly_income": 50000.00,
    "email": "joao.silva@example.com",
    "phone": {
        "international_dial_code": "55",
        "area_code": "11",
        "number": "987654321"
    }
}

Example: Parent Company (Legal Person)

Request Body

{
    "name": "Empresa Controladora Ltda",
    "document_number": "98.765.432/0001-11",
    "person_type": "legal_person",
    "related_party_type": "parent_company",
    "resident": true,
    "legal_representative": false,
    "direct_beneficiary": true,
    "address": {
        "postal_code": "02000-000",
        "street": "Avenida Principal",
        "number": "456",
        "neighborhood": "Jardim",
        "city": "São Paulo",
        "uf": "SP",
        "country": "BRA"
    },
    "participation_percentage": 0.8,
    "email": "contato@controladora.com.br",
    "phone": {
        "international_dial_code": "55",
        "area_code": "11",
        "number": "123456789"
    }
}

Body params

Field	Type	Description	Characters	Required
name	string	Related party name	1 - 255	Yes
document_number	string	CPF or CNPJ	1 - 18	Yes
person_type	string	Person Type enumerator	-	Yes
related_party_type	string	Related Party Type enumerator	-	Yes
resident	boolean	Defines if resident in Brazil	-	Yes
legal_representative	boolean	Defines if legal representative	-	Yes
direct_beneficiary	boolean	Defines if direct beneficiary	-	Yes
address	object	Address object	-	Yes
participation_percentage	number	Participation percentage (0 to 1)	-	Yes
email	string	Email	1 - 100	No
phone	object	Phone object	-	No
monthly_income	number	Monthly income	-	No
expiration_date	string	Expiration date (format: YYYY-MM-DD)	10	No

Person Type (Related Party)

Enumerator	Description
natural_person	Natural person
legal_person	Legal person

Related Party Type

Enumerator	Description
president	President
partner	Partner
administrator	Administrator
director	Director
manager	Manager
attorney	Attorney
parent_company	Parent company (only for legal person)
asset_custodian	Asset custodian

Address

Field	Type	Description	Characters	Required
postal_code	string	ZIP code	9	Yes
street	string	Street	1 - 255	No
number	string	Number	1 - 10	No
neighborhood	string	Neighborhood	1 - 255	No
city	string	City	1 - 255	No
uf	string	State	2	No
country	string	Country	3	No
complement	string	Complement	1 - 255	No

Phone

Field	Type	Description	Characters	Required
international_dial_code	string	International dial code	1 - 3	Yes
area_code	string	Area code	2	Yes
number	string	Phone number	8 - 9	Yes

Response

Response Body

{
    "related_party_key": "UUID",
    "external_related_party_key": "UUID",
    "name": "João Silva",
    "document_number": "123.456.789-00",
    "person_type": "natural_person",
    "related_party_type": "partner",
    "status": "active",
    "resident": true,
    "legal_representative": true,
    "direct_beneficiary": true,
    "address": {...},
    "participation_percentage": 0.5,
    "monthly_income": 50000.00,
    "email": "joao.silva@example.com",
    "phone": {...}
}