Brazil CVM Filings for NGO and Policy Research

Policy and Brazil filings NGO policy teams cite issuer disclosures — environmental contingencies, community risk, governance. apicvm returns the underlying DFP/ITR/FRE files over HTTP. It is not an advocacy CRM or a full dados.gov dump.

The persona

NGO researchers documenting listed-company risk narratives
Think-tank staff comparing FRE language across sectors
Investigative desks that need reproducible PDF citations

The problem

Secondary ESG scores hide the issuer's own wording. Portal downloads are hard to reproduce in footnotes. Document UUIDs fix that.

Solution flow

Issuer list → FRE name filters (risco, socioambiental, etc.) → download → cite

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

Example: sector risk language sample

import os, requests

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

for t in ["VALE3", "SBSP3", "CSAN3"]:
    docs = requests.get(
        f"{BASE}/v1/documents",
        headers=H,
        params={"ticker": t, "type": "FRE", "year": 2024, "name": "Risco", "perPage": 10},
    ).json()["data"]
    print(t, len(docs))

Current limitations

Not a substitute for government open-data CSVs when you need bulk statistical tables — see CVM open data alternative
Name filters need human validation of titles
Corpus is not every issuer every year

Next steps

Ready to integrate?

Get an API key and start querying Brazilian CVM filings programmatically.

Read the API docs Get API key