Consultar Pedido de Resgate por chave

Retorna um pedido de resgate de um investidor pela chave.

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Leitura

URL base de cada host: Ambientes (Hosts).

Request

ENDPOINT

/quota/investor/INVESTOR_KEY/redemption_request/REDEMPTION_REQUEST_KEY

MÉTODO

GET

STATUS

200

A gestora só consulta pedidos de resgate de fundos dela.

Responses

Caso 01: Consulta bem-sucedida

{
    "redemption_request_key": "UUID",
    "redemption_request_type": "gross_redemption_value",
    "status": "quoted",
    "quotation_date": "2025-01-15",
    "payment_date": "2025-01-16",
    "payment_method": "regular",
    "request_datetime": "2025-01-14T13:05:00Z",
    "redemption_request_data": {
        "gross_redemption_value": 1000.0
    },
    "processed_value": 1000.0,
    "ir_value": 2.78,
    "iof_value": 0.0,
    "investor": {
        "investor_key": "UUID",
        "name": "INVESTIDOR EXEMPLO",
        "person_type": "natural_person",
        "document_number": "969.698.790-03",
        "distributor": {
            "distributor_key": "UUID",
            "document_number": "11.222.333/0001-81",
            "name": "DISTRIBUIDORA EXEMPLO",
            "account_data": {}
        }
    },
    "issuance_serie": {
        "issuance_serie_key": "UUID",
        "name": "SERIE 1",
        "sub_class": {
            "name": "COTA SÊNIOR",
            "sub_class_key": "UUID",
            "subordination_level": 1,
            "fund_class": {
                "name": "FUNDO EXEMPLO",
                "fund_class_key": "UUID",
                "document_number": "11.222.333/0001-81"
            }
        }
    },
    "payments": [
        {
            "payment_key": "UUID",
            "origin_key": "UUID",
            "total_value": 997.22,
            "payment_type": "redemption.investor",
            "payment_date": "2025-01-16",
            "status": "paid"
        }
    ],
    "status_events": [
        {
            "status": "pending_quote",
            "event_datetime": "2025-01-14T13:05:00Z"
        },
        {
            "status": "quoted",
            "event_datetime": "2025-01-15T21:00:00Z"
        }
    ]
}

Redemption Request

Campo	Tipo	Descrição
redemption_request_key	string	Chave única do pedido de resgate
redemption_request_type	string	Enumerador de Redemption Request Type
status	string	Enumerador de Redemption Request Status
quotation_date	string	Data de cotização
payment_date	string	Data de pagamento
payment_method	string	regular ou b3
request_datetime	string	Data e hora da criação do pedido (UTC)
redemption_request_data	object	Valores enviados na criação (ex.: gross_redemption_value, net_value)
processed_value	float	Valor processado do resgate
ir_value	float	IR do resgate
iof_value	float	IOF do resgate
investor	object	Investidor: investor_key, name, person_type, document_number e distributor
issuance_serie	object	Série de emissão, com sub_class e sub_class.fund_class
payments	array	Pagamentos gerados (investidor, IR, IOF): payment_key, origin_key, total_value, payment_type, payment_date, status, status_events
status_events	array	Histórico de status: status e event_datetime (UTC)
cancellation_data	object	Dados do cancelamento, só quando o pedido foi cancelado

Redemption Request Type

Enumerador	Descrição
gross_redemption_value	Resgate por valor bruto
number_of_quotas	Resgate por número de cotas
remaining_application_value	Resgate por posição remanescente
net_value_redemption	Resgate por valor líquido

Redemption Request Status

Enumerador	Descrição
created	Criado
pending_manager_approval	Aguardando aprovação da gestora
pending_quote	Pendente de cotização
processing_quotation	Cotização em processamento
pending_quotation_date_input	Aguardando definição da data de cotização
processing_issuance_serie_impacts	Processando impactos na série
quoted	Cotizado
canceled	Cancelado
reprocessed	Reprocessado

Erros

Status	Código	Quando acontece
400	QIT000004	O pedido de resgate não é de um fundo da gestora
404	QTA000036	Pedido de resgate não encontrado para o investidor

Erros de autenticação, permissão e host: veja Erros da API.