Solicitação de Acesso aos Dados do Investidor

Clientes que cadastraram um investidor que já possui um cadastro único precisam solicitar acesso aos dados do investidor para que possam emitir operações com esse investidor como parte.

Ao realizar essa solicitação, o investidor receberá um e-mail com instruções para aprovar ou recusar o acesso.

---

Solicitação de Acesso (POST)

Request

ENDPOINT

/investor_management/investor/INVESTOR-KEY/data_access_request

MÉTODO

POST

Path Params

Campo	Tipo	Descrição	Caracteres Máx.
INVESTOR-KEY *	string	Chave única do investidor (UUID v4).	36

---

Request Body

Nenhum corpo de requisição é necessário.

---

Response

STATUS

201

Response Body

{
    "data_access_request_key": "6beb9e44-1513-4d3b-9af5-f3c39ebbf2d0",
    "requested_at": "2025-02-22T10:45:49.609517",
    "responded_at": null,
    "data_access_request_status": "in_analysis"
}

Response Body Params

Campo	Tipo	Descrição	Caracteres Máx.
data_access_request_key *	string	Chave única da solicitação de acesso (UUID v4).	36
requested_at *	string	Data e hora da solicitação (formato ISO 8601).	-
responded_at	string	Data e hora da resposta à solicitação, se já respondida.	-
data_access_request_status *	string	Status da solicitação.	Enumeradores data_access_request_status

---

Consulta do Status da Solicitação (GET)

Os clientes podem verificar se sua solicitação foi aprovada, recusada ou ainda está em análise.

Request

ENDPOINT

/investor_management/investor/INVESTOR-KEY/data_access_request

MÉTODO

GET

Path Params

Campo	Tipo	Descrição	Caracteres Máx.
INVESTOR-KEY *	string	Chave única do investidor (UUID v4).	36

Response

STATUS

200

Response Body

[
    {
        "data_access_request_key": "6beb9e44-1513-4d3b-9af5-f3c39ebbf2d0",
        "requested_at": "2025-02-22T10:45:49.609517",
        "responded_at": null,
        "data_access_request_status": "in_analysis"
    }
]

Response Body Params

Campo	Tipo	Descrição	Caracteres Máx.
data_access_request_key *	string	Chave única da solicitação de acesso (UUID v4).	36
requested_at *	string	Data e hora da solicitação (formato ISO 8601).	-
responded_at	string	Data e hora da resposta à solicitação, se já respondida.	-
data_access_request_status *	string	Status da solicitação.	Enumeradores data_access_request_status

---

Enumeradores data_access_request_status

Enum	Descrição
in_analysis	A solicitação está em análise pelo investidor.
approved	O acesso foi aprovado e o cliente pode visualizar os dados do investidor.
reproved	A solicitação foi recusada e o cliente não poderá acessar os dados do investidor.