Send Investor Registration Data

---

Introduction

This resource is used to send the specific registration data of the person that is part of an investor's registration analysis.

The body sent must contain one of the natural_person or legal_person blocks, consistent with the person_type provided when the investor was created.

Input / Output

As input, send the registration data specific to the investor type.

As output, the analysis data object is returned, with the registration blocks already saved (natural_person or legal_person, address, net_worth, suitability, email, phone) and resident. The investor and analysis keys are not in the response: use the ones you already have.

fund_class investor

For investment funds (investor_sub_type: "fund_class"), the legal entity information (corporate name, incorporation date, etc.) is filled in automatically from the CVM database when the analysis is sent for validation. This step is not required for this sub-type.

Request

ENDPOINT

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

METHOD

PUT

STATUS

202

Request body

Example: Natural Person

Request Body

{
    "name": "João da Silva",
    "email": "joao.silva@example.com",
    "phone": {
        "international_dial_code": "55",
        "area_code": "11",
        "number": "987654321"
    },
    "natural_person": {
        "birthdate": "1990-05-15",
        "gender": "male",
        "mother_name": "Maria da Silva",
        "nationality": "BRA",
        "place_of_birth": {
            "country": "BRA",
            "uf": "SP",
            "city": "São Paulo"
        },
        "marital_status": "single",
        "spouse": {
            "name": "Maria Santos",
            "document_number": "969.698.790-03"
        },
        "profession": "Engenheiro",
        "occupation": "Engenheiro de Software",
        "occupation_company": {
            "name": "Empresa XYZ Ltda",
            "document_number": "22.333.444/0001-81"
        }
    }
}

Example: Legal Entity

Request Body

{
    "name": "Empresa XPTO Ltda",
    "email": "contato@empresaxpto.com.br",
    "phone": {
        "international_dial_code": "55",
        "area_code": "11",
        "number": "33334444"
    },
    "legal_person": {
        "legal_name": "Empresa XPTO Limitada",
        "constitution_date": "2020-01-15"
    }
}

Example: Legal Entity (fund_class)

Request Body

{
    "name": "Empresa XPTO Ltda",
    "email": "contato@empresaxpto.com.br",
    "phone": {
        "international_dial_code": "55",
        "area_code": "11",
        "number": "33334444"
    },
    "legal_person": {
        "giin_number": "XXXXXX.XXXXX.XX.XXX"
    }
}

Body params

Field	Type	Description	Characters	Required
name	string	Name (or corporate name) of the investor	1 - 255	No
email	string	Contact e-mail	1 - 255	No
phone	object	Phone object	-	No
natural_person	object	Natural Person object — required for a natural person	-	Yes*
legal_person	object	Legal Person object — required for a legal entity	-	Yes*
nif_number	string	NIF (foreign tax identification number). Required for a non-resident investor (IVR000224)	1 - 50	Conditional
non_resident_type	string	Can only repeat the value sent when the investor was created (IVR000225)	-	No

* You must send exactly one of natural_person or legal_person, according to the investor's person_type.

Natural Person

Field	Type	Description	Characters	Required
birthdate	string	Date of birth (YYYY-MM-DD)	10	Yes
mother_name	string	Mother's full name	1 - 255	Yes
father_name	string	Father's full name	1 - 255	No
nationality	string	Nationality — 3-letter ISO code (e.g. BRA)	3	Yes
place_of_birth	object	Place of Birth object	-	Yes
marital_status	string	Marital Status enumerator	-	Yes
profession	string	Profession	1 - 255	Yes
occupation	string	Occupation	1 - 255	Yes
gender	string	Gender enumerator	-	No
spouse	object	Spouse object	-	No
occupation_company	object	Occupation Company object	-	No

Gender

Enumerator	Description
male	Male
female	Female

Marital Status

Enumerator	Description
single	Single
married	Married
civil_union	Civil union
divorced	Divorced
widowed	Widowed
married_with_partial_community_property	Married under partial community property

Place of Birth

Field	Type	Description	Characters	Required
country	string	ISO country code (3 letters, e.g. BRA)	3	Yes
uf	string	State (UF)	-	Yes
city	string	City	-	Yes

Spouse

Field	Type	Description	Characters	Required
name	string	Spouse's full name	1 - 255	Yes
document_number	string	Spouse's CPF (XXX.XXX.XXX-XX)	14	Yes

Occupation Company

Field	Type	Description	Characters	Required
name	string	Company name	1 - 255	Yes
document_number	string	Company CNPJ (XX.XXX.XXX/XXXX-XX)	18	Yes

Legal Person

Field	Type	Description	Characters	Required
legal_name	string	Company corporate name	1 - 255	No
constitution_date	string	Incorporation date (YYYY-MM-DD)	10	No
giin_number	string	GIIN (Global Intermediary Identification Number), when applicable	1 - 20	No

Phone

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

Response

The body carries the analysis data object with the blocks already saved. For the status and other fields, see Query Information of an Investor Registration Analysis.

---

Errors

Authentication, permission and host errors: see API Errors.