Skip to main content
BR FR / API · Brazil

Build on Brazil filings programmatically.

A typed REST API over 83,124 filings from 444 Brazilian listed companies — JSON metadata, Markdown body, and original PDF. Webhooks on every new release.

Public-company filings in Brazil are supervised by Comissão de Valores Mobiliários (CVM). Reporting follows IFRS / BR GAAP (CPC standards aligned with IFRS). Filings are most commonly published in Portuguese and English. Major issuers are listed on Ibovespa, IBrX 100 and IBrX 50. Calendar year.

Building on Brazilian filings programmatically

The FinancialReports API exposes CVM-supervised Brazilian filings through a single REST surface authenticated with one x-api-key header — the same key that works across all covered markets. A Brazil-only integration is a one-parameter filter (?country=BR) on the global filings endpoint, delivering DFPs, ITRs, Formulários de Referência, and Fatos Relevantes through a single endpoint without separate billing, a distinct API key, or a Brazil-specific rate-limit bucket.

For real-time pipelines the webhook subscription is the recommended path: subscribe once, receive a POST with full filing metadata within roughly 60 seconds of CVM / Empresas.NET publication. The payload shape is identical across all covered markets, so a Brazilian Fato Relevante arrives at your endpoint with the same JSON envelope as a Spanish CNMV disclosure or a UK RNS announcement. Country and filing-type routing is server-side; your consumer code stays market-agnostic and can filter on filing_type to separate periodic reports from ad-hoc disclosures without country-specific branching.

Filing bodies are available as JSON metadata (issuer, type, period, ISIN, governance tier, language), Markdown via /api/filings/{id}/markdown/ (the same processed text rendered on the public web pages, ready for downstream NLP or LLM ingestion), and the original PDF for audit trails. The Markdown layer is particularly valuable for Brazilian content because CVM filings — especially the multi-hundred-page Formulário de Referência — arrive as PDF-rendered documents with inconsistent layouts across issuers; the normalised Markdown removes that variability before it reaches your pipeline.

Typical use cases for the Brazilian API include backfilling Ibovespa and IBrX 100 consolidated IFRS financials for EM quant research, triggering signal generation off Fatos Relevantes (profit warnings, dividend changes, executive succession, commodity-contract updates), monitoring DFP and ITR release cadence for earnings calendars, and feeding Portuguese-language filings into LLM pipelines for Portuguese-speaking analyst tools or bilingual EM research platforms. Trial keys are available on request; the web product is free and publicly indexed, so coverage is verifiable before integration.

Filings indexed
83,124
in Brazil
Listed companies
444
Brazilian issuers
Auth
x-api-key
single header
Webhook latency
< 1 min
from regulator publish

Reporting at a glance — Brazil

Regulator, indices, accounting, language
Primary indices
IbovespaIBrX 100IBrX 50
Accounting standards
IFRS / BR GAAP (CPC standards aligned with IFRS)
Reporting languages
PortugueseEnglish
Fiscal year
Calendar year

Quick start — Brazil filings

REST · JSON · Markdown · PDF
# 1. List filings for Brazil, newest first
curl "https://api.financialreports.eu/api/filings/?countries=BR" \
    -H "x-api-key: $FR_API_KEY"

# 2. Pull full Markdown for one filing
curl https://api.financialreports.eu/api/filings/<id>/markdown/ \
    -H "x-api-key: $FR_API_KEY"

# 3. Filter by filing type — annual reports only
curl "https://api.financialreports.eu/api/filings/?countries=BR&type=10-K" \
    -H "x-api-key: $FR_API_KEY"

# 4. Filter by ISIN (single issuer)
curl "https://api.financialreports.eu/api/filings/?company_isin=DE000A1EWWW0" \
    -H "x-api-key: $FR_API_KEY"

Full API documentation ↗ · Interactive Swagger ↗

Sample Brazil response

Real filings · live data

Get API access for Brazil

Pricing · trial keys · enterprise
Get API access Talk to the team Read the docs ↗

Filings activity by year

Last 6 years · Brazilian issuers
  • 2026 2,335
  • 2025 3,549
  • 2024 5,295
  • 2023 6,917
  • 2022 6,586
  • 2021 6,693

Reporting languages

Filing-by-filing distribution
  • Portuguese 63,413
  • English 19,687
  • Spanish 1

FAQ — Brazil

Coverage, formats, integration
How do I authenticate API requests for Brazil filings?
Send a single header — `x-api-key: $FR_API_KEY` — on every request. The same key works across all 42 covered markets; there's no per-country key.
What format does the Brazil API return?
Filing metadata is returned as JSON. Full filing bodies are available as Markdown (one endpoint) and original PDF. The same payload shape is used across every covered market.
Do you provide webhooks for new Brazilian filings?
Yes. Webhook subscribers receive a POST with full filing metadata within ~60 seconds of the regulator publishing the document.
Is there a rate limit on the Brazilian API?
Standard plans are throttled to a generous request budget that suits typical research and dashboards. Bulk and high-throughput plans negotiate higher limits.
Is there a free tier for Brazil data?
The web product (search, browse, single-filing read) is free and indexed for the public web. Programmatic API access is a paid plan; trial keys are available on request.