Monitor Quarterly Earnings with Brazil ITR Filings

The problem

Short-term monitoring workflows face three blockers:

1. Timing — DFP covers the fiscal year; interim changes appear only in ITR.
2. Volume — active issuers file 30+ ITR-related documents per year; picking the latest quarter matters.
3. Format — quarterly footnotes and MD&A are inside PDFs, not in market-data APIs.

Teams that manually check CVM portals after each earnings season lose speed. Scraping breaks when layouts change. You need a stable API: resolve ticker → list ITR → extract → diff against prior quarter.

ITR vs DFP: when to use each

A practical monitoring stack uses ITR for quarterly deltas and DFP for annual baseline, with FRE for material events and forward-looking disclosures.

What to monitor in ITR

Production short-term analysis workflows typically track:

Compare the latest ITR against both the prior quarter's ITR and the annual DFP to spot trend breaks — for example, debt rising faster in Q3 than the annual filing suggested.

How apicvm helps

List latest ITR filings

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

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

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

Sort or filter list results by dateRef to identify the most recent quarter. Document names often include quarter indicators (e.g., "3T25" for Q3 2025).

Extract and compare quarters

import os, requests

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

itr_2025 = requests.get(
    f"{BASE}/v1/documents",
    params={"ticker": "VALE3", "type": "ITR", "year": 2025, "perPage": 50},
    headers=H,
).json()

# Sort by dateRef descending; extract the two most recent quarter filings
latest = sorted(itr_2025["data"], key=lambda d: d["dateRef"], reverse=True)[:2]

for doc in latest:
    requests.post(
        f"{BASE}/v1/document-text-extractions",
        json={"documentId": doc["id"], "callbackUrl": "https://your-server.example/callback"},
        headers=H,
    )

After callbacks deliver page markdown, run structured queries:

• Revenue and net income: current quarter vs prior quarter vs YTD
• Cash and debt: changes since last ITR and vs annual DFP
• Covenant compliance: any new disclosures on leverage limits
• Subsequent events: cross-check FRE if ITR references post-period items

Pair with FRE for context

ITR captures interim numbers; FRE often holds subsequent events, projection updates, and strategic commentary. For a complete short-term picture, list both:

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

curl -H "Authorization: Bearer $APICVM_KEY" \
  "$APICVM_URL/v1/documents?ticker=RADL3&type=FRE&year=2025&perPage=50"

Example: quarterly debt monitoring

A common pattern for credit-focused workflows:

1. Extract latest ITR footnotes on debt and covenants
2. Compare net debt/EBITDA against covenant threshold disclosed in DFP
3. Flag if quarterly footnotes show deteriorating headroom
4. Cite source page numbers from apicvm extraction callbacks

This mirrors how analysts review leverage trends between annual reports — but automated through the API.

Current limitations

• No quarter filter on list endpoint — filter by dateRef or document name client-side; there is no quarter query param in v1.
• Async text extraction — progress via callbacks only; no job status endpoint.
• Multiple files per quarter — issuers may file amendments; inspect names and dates carefully.
• Corpus coverage — ITR availability depends on ingestion; verify for your ticker and year.

Next steps

• Read the API docs
• Get an API key
• ITR filing type overview
• Extract DFP financial footnotes

Related guides

• Download DFP and ITR filings from Brazil
• List Brazil ITR filings (10-Q equivalent)
• Extract text from CVM PDFs for AI agents
• Analyze governance from FRE filings