Get Investor

This endpoint allows querying the complete details of an investor registered in the system, using their unique key.

---

Request

ENDPOINT

/investor_management/investor/INVESTOR-KEY

METHOD

GET

Path Params

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

Response

STATUS

200

Response Body

{
    "investor_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e",
    "name": "Fabrica Exemplo S.A.",
    "document_number": "96.146.194/0001-07",
    "status": "in_filling",
    "backoffice_analysis_status": "in_analysis",
    "person_type": "legal",
    "trading_name": "Fabrica 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": "2025-01-23T13:47:57.354528",
    "expiration_date": "2026-01-23",
    "signer_group_list": [],
    "bank_account_list": [],
    "investor_representative_list": [],
    "investor_contact_information_list": [],
    "investor_document_list": [],
    "investor_analysis_list": []
}

Response Body Params

Field	Type	Description	Max Characters
investor_key	string	Unique investor identifier.	36
name	string	Full investor name.	255
document_number	string	Investor document number (CNPJ).	14
status	string	Investor status	status Enumerators
backoffice_analysis_status	string	Backoffice analysis status.	-
person_type	string	Person type (legal or natural).	-
trading_name	string	Investor trade name.	1023
cnae_code	string	Investor CNAE code.	7
company_type	string	Company type Accepted: ´sa´, ´ltda´, ´cop´	50
foundation_date	string	Investor foundation date.	-
signer_group_list	array	List of signer groups associated with the investor.	-
bank_account_list	array	List of bank accounts associated with the investor.	-
investor_representative_list	array	List of investor representatives.	-
investor_contact_information_list	array	List of contact information associated with the investor.	-
investor_document_list	array	List of documents registered for the investor.	-
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

status Enumerators

Enum	Description
in_filling	In filling
in_analysis	Under analysis
canceled	Canceled
approved	Approved
reproved	Rejected
expired	Expired