Consulta paginada de Aplicação Financeira

Lista as aplicações financeiras de um cotista ou de uma classe de fundo, com paginação.

Por cotista

Retorna as aplicações financeiras de um cotista.

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Leitura

URL base de cada host: Ambientes (Hosts).

ENDPOINT

/quota/investor/INVESTOR_KEY/financial_applications

MÉTODO

GET

STATUS

200

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

Query Params

Parâmetro	Descrição
page	Página, a partir de 0 (default 0)
limit	Itens por página (default 20, máximo 500)
status	Lista de Financial Application Status
types	Lista de tipos: primary_market, secondary_market
issuance_serie_key	Filtra por série de emissão
quotation_date	Data de cotização (yyyy-mm-dd)
fund_class_document_number	CNPJ da classe de fundo
application_from_datetime	Aplicações com data/hora maior ou igual ao valor, no formato yyyy-mm-ddTHH:MM:SSZ (UTC)
application_to_datetime	Aplicações com data/hora menor ou igual ao valor, no formato yyyy-mm-ddTHH:MM:SSZ (UTC)

Por classe de fundo

Retorna as aplicações financeiras de uma classe de fundo da gestora, da mais recente para a mais antiga.

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Leitura

URL base de cada host: Ambientes (Hosts).

ENDPOINT

/quota/fund_class/FUND_CLASS_KEY/financial_applications

MÉTODO

GET

STATUS

200

Query Params

Parâmetro	Descrição
page	Página, a partir de 0 (default 0)
limit	Itens por página (default 20, máximo 100)
status	Lista de Financial Application Status
investor_name	Parte do nome do investidor (sem diferenciar maiúsculas)
investor_document_number	CPF/CNPJ do investidor
quotation_date	Data de cotização (yyyy-mm-dd)
application_from_datetime	Aplicações com data/hora maior ou igual ao valor, no formato yyyy-mm-ddTHH:MM:SSZ (UTC)
application_to_datetime	Aplicações com data/hora menor ou igual ao valor, no formato yyyy-mm-ddTHH:MM:SSZ (UTC)

limit acima do máximo devolve 400.

Response

As duas consultas devolvem a mesma estrutura. Cada item de data é o objeto Financial Application descrito em Consultar Aplicação Financeira por chave.

{
    "data": [
        {
            "financial_application_key": "UUID",
            "share_capital": 1000.0,
            "status": "quoted",
            "financial_application_type": "primary_market",
            "quotation_date": "2025-01-10"
        }
    ],
    "limit": 20,
    "page": 0,
    "is_last_page": true
}

Campo	Tipo	Descrição
data	array	Lista de aplicações financeiras
limit	int	Itens por página
page	int	Página retornada
is_last_page	boolean	true quando não há mais páginas

Erros

Status	Código	Quando acontece
400	QIT000001	Data ou data/hora em formato inválido
400	QIT000004	A gestora não é a gestora do fundo ou não está vinculada ao investidor
404	QTA000002	Classe de fundo não encontrada (consulta por classe)

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