Investor Representatives Registration

This endpoint allows registering representatives associated with a previously registered investor.

Request

ENDPOINT

/investor_management/investor/INVESTOR-KEY/investor_representative

METHOD

POST

Path Params

Field	Type	Description	Characters
`INVESTOR-KEY`	string	Unique investor key (UUID v4).	36

Request Body

Request Body

{
  "name": "João da Silva",
  "document_number": "123.456.789-01",
  "birthdate": "1990-01-01",
  "nationality": "Brasileiro",
  "mother_name": "Maria da Silva",
  "address": {
      "street": "Rua das Empresas",
      "neighborhood": "Centro",
      "number": "123",
      "postal_code": "01001-000",
      "city": "São Paulo",
      "state": "SP",
      "complement": "Sala 101"
  }
}

Request Body Params

Field	Type	Description	Max Characters
`name` *	string	Full name of the investor representative.	255
`document_number` *	string	Document number (CPF, format "XXX.XXX.XXX-XX").	11
`birthdate`*	string	Representative's birth date in ISO 8601 format (YYYY-MM-DD).	-
`document_identification_number`*	string	Document identification number.	255
`marital_status`*	string	Representative's marital status.	marital_status Enumerators
`property_system`*	string	Property regime.	property_system Enumerators
`nationality`*	string	Representative's nationality.	255
`mother_name`	string	Representative's mother's full name.	1023
`father_name`	string	Representative's father's full name.	1023
`occupation`*	string	Representative's occupation or profession.	255
`is_pep`*	boolean	Indicates if the representative is a Politically Exposed Person (PEP).	-
`address` *	string	Object referencing the address	address object

Address Object

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

marital_status Enumerators

Enum	Description
`single`	Single
`married`	Married
`widower`	Widowed
`separated`	Separated
`stable_union`	In Stable Union
`divorced`	Divorced

property_system Enumerators

Enum	Description
`total_communion_of_goods`	Total Communion of Goods
`partial_communion_of_goods`	Partial Communion of Goods
`total_separation_of_goods`	Total Separation of Goods
`final_participation_of_acquisitions`	Final Participation in Acquisitions
`compulsory_separation_of_goods`	Compulsory Separation of Goods

Response

STATUS

201

Response Body

{
  "investor_representative_key": "123e4567-e89b-12d3-a456-426614174000",
  "name": "João da Silva",
  "document_number": "123.456.789-01",
  "document_identification_number": "987654321",
  "marital_status": "single",
  "property_system": "partial_communion_of_goods",
  "birthdate": "1990-01-01",
  "nationality": "Brasileiro",
  "mother_name": "Maria da Silva",
  "father_name": "José da Silva",
  "occupation": "Advogado",
  "is_pep": false,
  "address": {
      "street": "Rua das Empresas",
      "neighborhood": "Centro",
      "number": "123",
      "postal_code": "01001-000",
      "city": "São Paulo",
      "state": "SP",
      "complement": "Sala 101"
  },
  "investor_representative_document_list": []
}

Response Body Params

Field	Type	Description	Max Characters
`investor_representative_key`	string	Unique identifier of the investor representative (UUID v4).	36
`name`	string	Full name of the investor representative.	255
`document_number`	string	Representative's document number (CPF format).	11
`document_identification_number`	string	Document identification number.	255
`marital_status`	string	Representative's marital status.	marital_status Enumerators
`property_system`	string	Property regime.	property_system Enumerators
`birthdate`	string	Representative's birth date.	-
`nationality`	string	Representative's nationality.	255
`mother_name`	string	Representative's mother's full name.	1023
`father_name`	string	Representative's father's full name.	1023
`occupation`	string	Representative's occupation or profession.	255
`is_pep`	boolean	Indicates if the representative is a Politically Exposed Person (PEP).	-
`address` *	string	Object referencing the address	address object
`investor_representative_document_list`	array	List of documents associated with the representative.	-

Investor Representatives Registration

Request​

Path Params​

Request Body​

Request Body Params​

Address Object​

marital_status Enumerators​

property_system Enumerators​

Response​

Response Body Params​