Obter Relatórios Gerenciais

Retorna os relatórios gerenciais mensais publicados na CVM, com composição patrimonial detalhada. Analise a alocação de ativos, estrutura de passivos e evolução do patrimônio dos FIIs.

Funcionalidades:

• Relatórios mensais: Um relatório por mês para cada FII
• Múltiplos FIIs: Consulte até 20 FIIs em uma única requisição
• Filtro por período: Especifique startDate e endDate (padrão: últimos 12 meses)
• Versionamento: Relatórios podem ter múltiplas versões (retificações). Por padrão, retorna apenas a mais recente. Use allVersions=true para todas as versões.
• Paginação: Controle o número de resultados por página
• Ordenação: Ordene por qualquer campo (referenceDate, totalAssets, equity, etc.)

KPIs Inclusos:

• Ativo Total — Patrimônio total do fundo (R$)
• Patrimônio Líquido — Equity (R$)
• Cotas — Número de cotas emitidas
• VP/Cota — Valor Patrimonial por Cota (R$)
• Taxa de Administração — Taxa anual (%)
• Retorno Mensal — Retorno do mês (%)
• Dividend Yield Mensal — DY do mês (%)
• Total de Investidores — Número de cotistas

Composição de Ativos:

• Caixa — Disponibilidades (R$)
• Títulos Públicos — Tesouro Direto, LTN, etc. (R$)
• Títulos Privados — Debêntures, CDB, etc. (R$)
• Fundos RF — Fundos de Renda Fixa (R$)
• Imóveis — Propriedades físicas (R$)
• CRI — Certificados de Recebíveis Imobiliários (R$)
• LCI — Letras de Crédito Imobiliário (R$)
• Cotas de FIIs — Investimentos em outros FIIs (R$)
• Recebíveis — Aluguéis, rendas a receber (R$)

Composição de Passivos:

• Distribuições a Pagar — Proventos não pagos (R$)
• Taxas Admin a Pagar — Taxas de administração (R$)
• Obrigações Imobiliárias — Financiamentos, empréstimos (R$)
• Total de Passivos — Soma de todas as obrigações (R$)

Administrador:

• administratorName — Nome da instituição administradora
• administratorCnpj — CNPJ da instituição administradora
• administratorAddress, administratorAddressNumber, administratorAddressComplement — Endereço informado à CVM
• administratorDistrict, administratorCity, administratorState, administratorZipCode — Localização do administrador
• administratorPhone1, administratorPhone2, administratorPhone3 — Telefones de contato
• administratorWebsite, administratorEmail — Site e email de contato

Autenticação:

Os FIIs MXRF11 e HGLG11 podem ser consultados sem autenticação para testes. Para acessar outros FIIs, é necessário um token de API válido.

Exemplos de Requisição:

# Relatórios dos últimos 12 meses (apenas versão mais recente)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/reports?symbols=HGLG11"

# Relatórios em período específico com paginação
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/reports?symbols=MXRF11,KNCR11&startDate=2024-01-01&endDate=2024-12-31&page=1&limit=10"

# Todas as versões dos relatórios (incluindo retificações)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/reports?symbols=XPLG11&allVersions=true&sortBy=referenceDate&sortOrder=desc"

Fonte dos Dados:

CVM (Comissão de Valores Mobiliários)

Plano Mínimo: Pro Autenticação: Necessária (exceto MXRF11 e HGLG11)