Brazil CVM Filings for Fintech Company Research

The persona

Typical users:

• Fintech engineers wiring issuer research into lending or wealth products
• Data teams enriching public-company profiles with original CVM sources
• Compliance tooling that archives peer disclosures with document IDs

Common input: a B3 ticker or CNPJ from an onboarding flow. Common output: the latest ITR, annual DFP, or FRE governance sections cited in an internal report.

The problem

Scraping the CVM portal breaks when HTML changes. Bulk open-data ZIPs require heavy ETL before you can answer "what did this issuer disclose last quarter?" Fintech flows often start with CNPJ — but product code and research screens use tickers.

You need:

1. Resolve CNPJ or ticker → stable issuer metadata
2. List filings by type and year
3. Download PDFs or extract text for ratio analysis and search

Solution: fintech research flow

Input: CNPJ or ticker
  → GET /v1/companies/resolve
  → GET /v1/documents — ITR (monitoring), DFP (ratios), FRE (governance)
  → GET /v1/documents/:id/file or POST /v1/document-text-extractions

Resolve by CNPJ (common in fintech flows)

export APICVM_KEY='apicvm_...'
export APICVM_URL='https://apicvm.dev'

curl -H "Authorization: Bearer $APICVM_KEY" \
  "$APICVM_URL/v1/companies/resolve?query=33592510000154&by=cnpj"

Returns issuer metadata including tickers — then list filings by ticker.

Monitor quarterly ITR for a watchlist

curl -H "Authorization: Bearer $APICVM_KEY" \
  "$APICVM_URL/v1/documents?ticker=VALE3&type=ITR&year=2025&perPage=10"

Pull DFP for financial statement extraction

curl -H "Authorization: Bearer $APICVM_KEY" \
  "$APICVM_URL/v1/documents?ticker=VALE3&type=DFP&year=2024&perPage=20"

Python: resolve + list for underwriting research

import os, requests

BASE = os.environ["APICVM_URL"]
H = {"Authorization": f"Bearer {os.environ['APICVM_KEY']}"}

# Resolve issuer — ticker or CNPJ
company = requests.get(
    f"{BASE}/v1/companies/resolve",
    headers=H,
    params={"query": "PETR4", "by": "ticker"},
).json()

ticker = company["tickers"][0] if company.get("tickers") else "PETR4"

for doc_type in ("ITR", "DFP", "FRE"):
    r = requests.get(
        f"{BASE}/v1/documents",
        headers=H,
        params={"ticker": ticker, "type": doc_type, "year": 2024, "perPage": 5},
    )
    r.raise_for_status()
    docs = r.json()["data"]
    print(f"{doc_type}: {len(docs)} documents — latest: {docs[0]['name'] if docs else 'none'}")

For automated ratio pipelines, download PDFs (no credits) or run async text extraction on Pro (credits per page).

Integration patterns

What apicvm does not replace

• Not a KYC provider — no identity verification, PEP/sanctions screening, or onboarding certification
• Not a credit bureau — no Serasa, Boa Vista, or private credit scores
• Not BACEN regulatory reporting — CVM filings for listed issuers, not central bank returns
• Not market prices — for quotes, use a market data API; see quotes vs filings
• Not private companies — public issuers in the ingested corpus only

Current limitations

• Corpus coverage lags ingestion — not a real-time filing alert service.
• No built-in compliance rules engine; you supply policy logic.
• Extraction is async and Pro-only; Student plan covers metadata and downloads.
• Do not claim regulatory compliance certification for your product based on apicvm access alone.

Next steps

• Read the API docs
• Get an API key
• Resolve Brazilian companies
• Brazil bank filings API
• Multi-ticker watchlist

Related pages

• PETR4 CVM filings · VALE3 CVM filings
• Compliance monitoring
• Access Brazilian CVM filings with Python