Consulta de Investidor

Este endpoint permite consultar os detalhes completos de um investidor cadastrado no sistema, utilizando sua chave única.

---

Request

ENDPOINT

/investor_management/investor/INVESTOR-KEY

MÉTODO

GET

Path Params

Campo	Tipo	Descrição	Caracteres
INVESTOR-KEY	string	Chave única do investidor (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

Campo	Tipo	Descrição	Máximo de Caracteres
investor_key	string	Identificador único do investidor.	36
name	string	Nome completo do investidor.	255
document_number	string	Número do documento do investidor (CNPJ).	14
status	string	Status do investidor	Enumeradores status
backoffice_analysis_status	string	Status de análise do backoffice.	-
person_type	string	Tipo de pessoa (legal ou natural).	-
trading_name	string	Nome fantasia do investidor.	1023
cnae_code	string	Código CNAE do investidor.	7
company_type	string	Tipo de empresa Aceitos: ´sa´, ´ltda´, ´cop´	50
foundation_date	string	Data de fundação do investidor.	-
signer_group_list	array	Lista de grupos de assinantes associados ao investidor.	-
bank_account_list	array	Lista de contas bancárias associadas ao investidor.	-
investor_representative_list	array	Lista de representantes do investidor.	-
investor_contact_information_list	array	Lista de informações de contato associadas ao investidor.	-
investor_document_list	array	Lista de documentos cadastrados para o investidor.	-
address *	string	Objeto referenciando o endereço	Objeto address

Objeto Address

Campo	Tipo	Descrição	Caracteres Máx.
street *	string	Nome da rua do endereço da empresa.	500
neighborhood	string	Nome do bairro do endereço da empresa.	100
number *	string	Número do endereço.	10
postal_code *	string	CEP do endereço (somente números).	8
city *	string	Nome da cidade do endereço.	255
state *	string	Sigla do estado (2 caracteres).	2
complement	string	Complemento do endereço, se aplicável.	100

Enumeradores status

Enum	Description
in_filling	Em preenchimento
in_analysis	Em análise
canceled	Cancelado
approved	Aprovado
reproved	Reprovado
expired	Expirado