Investor Registration

This endpoint allows registering the basic information of an investor.

Request

ENDPOINT

/investor_management/investor

METHOD

POST

Request Body

Request Body

{
  "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"
  }
}

Request Body Params

Field	Type	Description	Max Characters
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 *	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 (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

Response

STATUS

201

Response Body

{
    "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"
  }

Response Body Params

Field	Type	Description	Max Characters
investor_key	string	Unique investor key (UUID).	36
name	string	Full investor name.	255
document_number	string	Investor CNPJ.	14
status	string	Investor status.	-
person_type	string	Person type	person_type Enumerators
trading_name	string	Investor trade name.	1023
cnae_code	string	Investor CNAE code.	7
company_type	string	Company type	company_type Enumerators
foundation_date	string	Investor foundation date.	-
address	string	Object referencing the address	address object
registration_datetime	string	Investor registration date and time.	-
expiration_date	string	Investor expiration date.	-

person_type Enumerators

Enum	Description
legal	Legal Entity
natural	Natural Person