Consulta Informações do Investidor

---

Introdução

Este recurso retorna os dados completos de um investidor — incluindo suas análises cadastrais, lotes de documentos, eventos de status, distribuidor e usuário cadastrador.

Input / Output

Não há corpo de requisição. As chaves de identificação são passadas no path.

Como output será retornada a representação atual do investidor.

Request

ENDPOINT

/investor_registry/investor/{investor_key}

MÉTODO

GET

STATUS

200

Endpoints relacionados

• Listar investidores do agente: GET /investor_registry/investors (paginado, com filtros name, document_number, status).
• Listar investidores possuídos por um investor owner (uso típico: fund class): GET /investor_registry/investor/{investor_key}/investors.

Response

Caso 01: Pessoa Física

{
   "investor_key": "UUID",
   "name": "João da Silva",
   "document_number": "123.456.789-00",
   "status": "pending_analysis",
   "email": "joao@example.com",
   "person_type": "natural_person",
   "phone": {
      "number": "987654321",
      "area_code": "11",
      "international_dial_code": "55"
   },
   "distributor": {
      "distributor_key": "UUID",
      "name": "Distribuidor XPTO",
      "document_number": "00.000.000/0000-00"
   },
   "analyses": [
      {
         "investor_analysis_key": "UUID",
         "analysis_datetime": "2025-04-29 12:07:55.059999",
         "status": "pending_registry_data"
      }
   ],
   "document_batches": [],
   "status_events": [
      {
         "status": "pending_analysis",
         "event_datetime": "2025-04-29 12:07:55.000000"
      }
   ]
}

Caso 02: Pessoa Jurídica — Fundo de Investimento

{
   "investor_key": "UUID",
   "name": "Fundo XPTO Multimercado",
   "document_number": "12.345.678/0001-90",
   "status": "registered",
   "person_type": "legal_person",
   "investor_sub_type": "fund_class",
   "distributor": {
      "distributor_key": "UUID",
      "name": "Distribuidor XPTO",
      "document_number": "00.000.000/0000-00"
   },
   "analyses": [
      {
         "investor_analysis_key": "UUID",
         "analysis_datetime": "2025-04-29 12:07:55.059999",
         "status": "manually_approved"
      }
   ],
   "document_batches": [
      {
         "document_batch_key": "UUID",
         "status": "signed",
         "documents": [
            {
               "investor_document_key": "UUID",
               "type": "legal_person_registry_form",
               "status": "signed"
            }
         ]
      }
   ],
   "status_events": [
      {
         "status": "registered",
         "event_datetime": "2025-04-29 13:08:25.673902"
      }
   ]
}

Investor

Campo	Tipo	Descrição
investor_key	string	Chave única de identificação do investidor
name	string	Nome (ou razão social) do investidor
document_number	string	CPF / CNPJ do investidor
email	string	E-mail de contato
phone	object	Objeto de Phone
status	string	Enumerador de Investor Status
person_type	string	Enumerador de Person Type
investor_sub_type	string	Enumerador de Investor Sub Type, quando aplicável
distributor	object	Objeto de Distributor
analyses	array	Lista de objetos de Investor Analysis
document_batches	array	Lista de objetos de Document Batch
status_events	array	Lista de objetos de Status Event

Phone

Campo	Tipo	Descrição	Caracteres
international_dial_code	string	Código internacional	1 - 3
area_code	string	DDD	2
number	string	Número de telefone	8 - 9

Investor Status

Enumerador	Descrição
created	Criado
pending_analysis	Pendente análise
pending_documents	Pendente documentos
incomplete	Cadastro incompleto
pending_update	Pendente atualização
registered	Cadastrado
registry_expired	Cadastro expirado

Person Type

Enumerador	Descrição
natural_person	Pessoa física
legal_person	Pessoa jurídica
nominee	Nominee / PCO

Investor Sub Type

Enumerador	Descrição
default	Pessoa jurídica regular
financial_institution	Instituição financeira
fund_class	Fundo de investimento
non-resident	Não-residente

Distributor

Campo	Tipo	Descrição
distributor_key	string	Chave única do distribuidor
name	string	Nome do distribuidor
document_number	string	CNPJ do distribuidor

Investor Analysis

Campo	Tipo	Descrição
investor_analysis_key	string	Chave única da análise cadastral
analysis_datetime	string	Data/hora de criação da análise
status	string	Enumerador de Investor Analysis Status
registry_user	object	Objeto de Registry User, quando presente

Document Batch

Campo	Tipo	Descrição
document_batch_key	string	Chave única do lote de documentos
status	string	Enumerador de Document Batch Status
documents	array	Lista de objetos de Investor Document

Investor Document

Campo	Tipo	Descrição
investor_document_key	string	Chave única do documento do investidor
type	string	Enumerador de Document Type
status	string	Enumerador de Investor Document Status

Registry User

Campo	Tipo	Descrição
registry_user_key	string	Chave única do usuário cadastrador
kc_user_id	string	ID do usuário no KeyCloak
name	string	Nome
document_number	string	CPF
email	string	E-mail
phone	object	Objeto de Phone

Investor Analysis Status

Enumerador	Descrição
created	Criada
pending_registry_data	Pendente dados cadastrais
pending_documents	Pendente documentos
sent_to_analysis	Enviada para análise
in_manual_analysis	Em análise manual
automatically_approved	Aprovada automaticamente
automatically_reproved	Reprovada automaticamente
manually_approved	Aprovada manualmente
manually_reproved	Reprovada manualmente
expired	Expirada

Document Batch Status

Enumerador	Descrição
creating_documents	Documentos sendo gerados
send_to_signature	Enviado para assinatura
pending_signature	Aguardando assinatura
signed	Assinado

Document Type

Enumerador	Descrição
cnh	CNH
rg	RG
rg_back	RG — verso
rg_front	RG — frente
proof_of_residence	Comprovante de residência
cnpj_card	Cartão CNPJ
financial_statements	Demonstrações financeiras
social_contract	Contrato social
company_statute	Estatuto
board_election_record	Ata de eleição
fund_prospectus	Regulamento do fundo
power_of_attorney	Procuração
billing_statement	Fatura / extrato
investor_qualification_proof	Comprovação de qualificação
qualified_investor_term	Termo de investidor qualificado
professional_investor_term	Termo de investidor profissional
natural_person_registry_form	Ficha cadastral — pessoa física
legal_person_registry_form	Ficha cadastral — pessoa jurídica

Investor Document Status

Enumerador	Descrição
sent_to_generate	Enviado para ser gerado
generated	Gerado
signed	Assinado

Status Event

Campo	Tipo	Descrição
status	string	Enumerador de status
event_datetime	string	Data/hora do evento