Investor Registration

This endpoint allows registering the basic information of an investor. The same endpoint is used for both legal entity (PJ) and natural person (PF) investors — the request body varies according to the person_type field.

Request

ENDPOINT

/investor_management/investor

METHOD

POST

Request Body

Case 01: Legal Entity

{
  "name": "Empresa Exemplo S.A.",
  "document_number": "12.345.678/0001-95",
  "trading_name": "Exemplo Comércio",
  "cnae_code": "62.02-3-00",
  "company_type": "sa",
  "foundation_date": "2000-01-01",
  "address": {
      "street": "Rua das Empresas",
      "neighborhood": "Centro",
      "number": "123",
      "postal_code": "01001-000",
      "city": "São Paulo",
      "state": "SP",
      "complement": "Sala 101"
  }
}

Case 02: Natural Person

{
  "person_type": "natural",
  "name": "Maria Exemplo da Silva",
  "document_number": "123.456.789-00",
  "document_identification_number": "12.345.678-9",
  "marital_status": "single",
  "property_system": null,
  "birthdate": "1990-05-14",
  "nationality": "BRA",
  "mother_name": "Joana Exemplo da Silva",
  "father_name": "José Exemplo da Silva",
  "occupation": "software engineer",
  "is_pep": false,
  "email": "maria.exemplo@example.com",
  "phone_number": "+5511999999999",
  "investor_category": "retail",
  "investment_suitability": "moderate",
  "address": {
      "street": "Rua Exemplo",
      "neighborhood": "Centro",
      "number": "45",
      "postal_code": "01001-000",
      "city": "São Paulo",
      "state": "SP",
      "complement": "Apto 12"
  }
}

Attention

If the person_type field is omitted, the registration is treated as Legal Entity (legal). To register a Natural Person investor, send person_type: "natural".

Request Body Params — Legal Entity

Field	Type	Description	Max Characters
`person_type`	string	Optional. If omitted, the registration is treated as Legal Entity (`legal`).	person_type Enumerators
`name` *	string	Full company name.	255
`document_number` *	string	Company CNPJ (format "XX.XXX.XXX/XXXX-XX").	14
`trading_name`*	string	Company trade name.	1023
`cnae_code`*	string	Company CNAE code (format "XXXXX-XXX").	7
`company_type`*	string	Company type.	company_type Enumerators
`foundation_date`*	string	Company foundation date (format "YYYY-MM-DD").	-
`address` *	object	Object referencing the address	address object

Request Body Params — Natural Person

Field	Type	Description	Max Characters
`person_type` *	string	Must be sent as `"natural"`.	person_type Enumerators
`name` *	string	Investor's full name.	255
`document_number` *	string	Investor's CPF (format "XXX.XXX.XXX-XX").	14
`document_identification_number`*	string	Investor's identity document number (RG, CNH, or passport).	255
`marital_status`*	string	Investor's marital status.	marital_status Enumerators
`property_system`	string	Marital property regime. Required only when `marital_status` requires a property regime.	property_system Enumerators
`birthdate`*	string	Investor's date of birth (format "YYYY-MM-DD").	-
`nationality`*	string	Investor's nationality.	nationality Enumerators
`mother_name`*	string	Investor's mother's name.	1023
`father_name`*	string	Investor's father's name.	1023
`occupation`*	string	Investor's occupation/profession.	255
`is_pep`*	boolean	Indicates whether the investor is a Politically Exposed Person.	-
`email`*	string	Investor's contact email.	1023
`phone_number`*	string	Investor's contact phone number.	20
`investor_category`	string	Investor's self-declared category. Optional.	investor_category Enumerators
`investment_suitability`	string	Investor's self-declared suitability profile. Optional.	investment_suitability Enumerators
`address` *	object	Object referencing the address	address object

Address Object

Field	Type	Description	Max Characters
`street` *	string	Street name of the address.	500
`neighborhood` *	string	Neighborhood name of the address.	100
`number` *	string	Address number.	10
`postal_code` *	string	Address postal code (format "XXXXX-XXX").	8
`city` *	string	City name of the address.	255
`state` *	string	State abbreviation (2 characters).	2
`complement`	string	Address complement, if applicable.	100

company_type Enumerators

Enum	Description
`ltda`	Limited Company
`sa`	Sociedade Anônima
`cop`	Cooperative

marital_status Enumerators

Enum	Description
`single`	Single
`married`	Married
`divorced`	Divorced
`widowed`	Widowed
`separated`	Separated

property_system Enumerators

Enum	Description
`total_communion_of_goods`	Universal community of property
`partial_communion_of_goods`	Partial community of property
`total_separation_of_goods`	Total separation of property
`final_participation_of_acquisitions`	Final participation in acquisitions
`compulsory_separation_of_goods`	Mandatory separation of property

nationality Enumerators

Full list of ISO 3166-1 alpha-3 codes (e.g., BRA for Brazil, USA for the United States).

investor_category Enumerators

Enum	Description
`not_applicable`	Not applicable
`retail`	Retail
`qualified`	Qualified
`professional`	Professional

investment_suitability Enumerators

Enum	Description
`conservative`	Conservative
`moderate`	Moderate
`bold`	Bold

Response

STATUS

201

Case 01: Legal Entity

{
    "investor_key": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Empresa Exemplo S.A.",
    "document_number": "12.345.678/0001-95",
    "status": "in_filling",
    "person_type": "legal",
    "trading_name": "Exemplo Comércio",
    "cnae_code": "62.02-3-00",
    "company_type": "sa",
    "foundation_date": "2000-01-01",
    "address": {
      "street": "Rua das Empresas",
      "neighborhood": "Centro",
      "number": "123",
      "postal_code": "01001-000",
      "city": "São Paulo",
      "state": "SP",
      "complement": "Sala 101"
    },
    "registration_datetime": "2023-01-01T12:00:00Z",
    "expiration_date": "2024-01-01T12:00:00Z"
  }

Case 02: Natural Person

{
  "investor_key": "9f8e7d6c-5b4a-3210-9876-543210fedcba",
  "name": "Maria Exemplo da Silva",
  "document_number": "123.456.789-00",
  "status": "in_filling",
  "person_type": "natural",
  "document_identification_number": "12.345.678-9",
  "marital_status": "single",
  "birthdate": "1990-05-14",
  "nationality": "BRA",
  "occupation": "software engineer",
  "is_pep": false,
  "investor_category": "retail",
  "investment_suitability": "moderate",
  "address": {
    "street": "Rua Exemplo",
    "neighborhood": "Centro",
    "number": "45",
    "postal_code": "01001-000",
    "city": "São Paulo",
    "state": "SP",
    "complement": "Apto 12"
  },
  "registration_datetime": "2023-01-01T12:00:00Z",
  "expiration_date": "2024-01-01T12:00:00Z",
  "investor_contact_information_list": [
    {
      "investor_contact_information_key": "3f1e2d3c-4b5a-6978-8899-aabbccddeeff",
      "name": "Maria Exemplo da Silva",
      "document_number": "123.456.789-00",
      "email": "maria.exemplo@example.com",
      "phone_number": "+5511999999999",
      "is_default": true
    }
  ],
  "signer_group_list": [
    {
      "signer_group_key": "7a6b5c4d-3e2f-1a0b-9c8d-1234567890ab",
      "minimum_required_signers": 1,
      "signers": [
        {
          "name": "Maria Exemplo da Silva",
          "document_number": "123.456.789-00",
          "email": "maria.exemplo@example.com",
          "phone_number": "+5511999999999",
          "is_group_mandatory": true
        }
      ]
    }
  ]
}

Information

investor_contact_information_list and signer_group_list are only returned when the registration is done with full access (data_access_type == full_access).

Response Body Params

Field	Type	Person	Description	Max Characters
`investor_key`	string	Both	Unique investor key (UUID).	36
`name`	string	Both	Full name (PF) or company name (PJ).	255
`document_number`	string	Both	Investor's CPF (PF) or CNPJ (PJ).	14
`status`	string	Both	Investor status.	-
`person_type`	string	Both	Person type	person_type Enumerators
`trading_name`	string	PJ only	Investor trade name.	1023
`cnae_code`	string	PJ only	Investor CNAE code.	7
`company_type`	string	PJ only	Company type	company_type Enumerators
`foundation_date`	string	PJ only	Investor foundation date.	-
`document_identification_number`	string	PF only	Investor's identity document number.	255
`marital_status`	string	PF only	Investor's marital status.	marital_status Enumerators
`birthdate`	string	PF only	Investor's date of birth.	-
`nationality`	string	PF only	Investor's nationality.	nationality Enumerators
`occupation`	string	PF only	Investor's occupation/profession.	255
`is_pep`	boolean	PF only	Indicates whether the investor is a PEP.	-
`investor_category`	string	PF only	Investor's self-declared category.	investor_category Enumerators
`investment_suitability`	string	PF only	Self-declared suitability profile.	investment_suitability Enumerators
`address`	object	Both	Object referencing the address	address object
`investor_contact_information_list`	array	PF only	Investor's contact information list. Only with `data_access_type == full_access`.	-
`signer_group_list`	array	PF only	Investor's signer group list. Only with `data_access_type == full_access`.	-
`registration_datetime`	string	Both	Investor registration date and time.	-
`expiration_date`	string	Both	Investor expiration date.	-

person_type Enumerators

Enum	Description
`legal`	Legal Entity
`natural`	Natural Person

Request​

Request Body​

Request Body Params — Legal Entity​

Request Body Params — Natural Person​

Address Object​

company_type Enumerators​

marital_status Enumerators​

property_system Enumerators​

nationality Enumerators​

investor_category Enumerators​

investment_suitability Enumerators​

Response​

Response Body Params​

person_type Enumerators​