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 fund classes (investor_sub_type: "fund_class"), this step is required — send the legal_person block with the contact data and, when applicable, the giin_number.

Corporate name, incorporation date and net worth do not need to be sent: they are filled in automatically from the CVM database when the analysis is sent for validation.

Request

ENDPOINT

/investor_registry/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": "1234567890"
    },
    "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": "1234567890"
    },
    "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*

* 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
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	No
uf	string	State (UF)	-	No
city	string	City	-	No

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

Status	Code	When it happens
400	IVR000018	The analysis is no longer in pending_registry_data (it has already been sent or closed)
400	IVR000224	Non-resident investor without nif_number
400	IVR000225	non_resident_type differs from the one provided when the investor was created
422	IVR000245 / IVR000246 / IVR000249	Fund class not found, canceled or not operational at CVM
400	QIT000011	Through the manager (manager-api): the investor is not a fund class linked to it

Authentication, permission and host errors: see API Errors.