Pular para o conteúdo principal

Consulta paginada de pedidos de resgate por investidor

Retorna os pedidos de resgate de um investidor identificado por investor_key, com paginação e filtros opcionais. A lista é ordenada por fundo, subclasse, série e data de cotização (mais recente primeiro).

Disponível em
PerfilHostPermissão exigida
Gestoramanager-apiLeitura

URL base de cada host: Ambientes (Hosts).

Request​

ENDPOINT
/quota/investor/{investor_key}/redemption_requests
MÉTODO
GET

Para a gestora, a consulta retorna apenas pedidos em fundos dela, e só de investidores aos quais ela está vinculada.

Query params​

ParâmetroTipoObrigatoriedadeDescrição
pageintegeropcionalNúmero da página (começa em 0). Padrão: 0.
limitintegeropcionalRegistros por página. Padrão: 20. Máximo: 500.
statusarray de stringsopcionalUm ou mais status do pedido. Repita o parâmetro para enviar mais de um.
quotation_datestringopcionalFiltra pela data de cotização no formato YYYY-MM-DD.
fund_class_document_numberstringopcionalFiltra pelo CNPJ da classe de fundo.
request_from_datetimestring (date-time)opcionalPedidos com data/hora de solicitação maior ou igual ao valor, no formato YYYY-MM-DDTHH:MM:SSZ (UTC).
request_to_datetimestring (date-time)opcionalPedidos com data/hora de solicitação menor ou igual ao valor, no formato YYYY-MM-DDTHH:MM:SSZ (UTC).
Exemplo de chamada
GET /quota/investor/{investor_key}/redemption_requests?page=0&limit=20&status=quoted&quotation_date=2024-06-15

Response​

STATUS
200

Cada item de data é o objeto Redemption Request completo, descrito em Consultar Pedido de Resgate por chave — lá estão também os tipos e os status.

Response Body (resumido)
{
"data": [
{
"redemption_request_key": "UUID",
"redemption_request_type": "number_of_quotas",
"status": "quoted",
"quotation_date": "2024-06-15",
"payment_date": "2024-06-18",
"payment_method": "regular",
"request_datetime": "2024-06-10T14:00:00Z",
"redemption_request_data": {
"number_of_quotas": 500.0
},
"processed_value": 5250.5,
"ir_value": 0.0,
"iof_value": 0.0
}
],
"limit": 20,
"page": 0,
"is_last_page": true
}
CampoTipoDescrição
dataarrayPedidos de resgate
limitintegerItens por página
pageintegerPágina retornada
is_last_pagebooleantrue quando não há mais páginas

Um valor de status que não existe não gera erro: a consulta apenas não encontra pedidos.

Erros​

StatusCódigoQuando acontece
400QIT000001Data ou data/hora em formato inválido
400QIT000004A gestora não está vinculada ao investidor
404QTA000021Investidor não encontrado

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