apicvm.dev
Download llms.txt Get API key

VALE3 CVM Filings — Documents and API Access

VALE3 is the ordinary share ticker for Vale S.A., one of the world's largest mining companies and a major B3-listed issuer. If you need VALE3 CVM filings for models, research, or AI agents, apicvm lets you resolve the company, list regulatory documents by type and year, and download originals or extract page-level text.

Company overview

Field Value
Name VALE S.A.
Ticker VALE3 (ON — ordinary shares)
CNPJ 33592510000154
Sector Extração Mineral
Regulator CVM (Comissão de Valores Mobiliários)

Vale may also appear under other share classes. Use GET /v1/companies/resolve with the ticker you need.

Document types available

In the apicvm corpus, VALE3 filings include the main CVM types:

Type Description Typical use
DFP Annual standardized financial statements Full-year financials, audited statements
ITR Quarterly financial information Interim results, quarterly monitoring
FRE Formulário de Referência Company profile, risks, governance

Document counts in the current corpus (Hold database, queried 2026-07-14):

Year DFP ITR FRE
2025 20 31 78
2024 20 30 78

Counts include all files filed under each type for the year. Inspect list results to pick the right document by name and dateRef.

Resolve VALE3

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"

Expected response fields: id, name, cnpj, sector, tickers[].

List VALE3 ITR filings (2024)

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

Sort results by dateRef to walk fiscal quarters. See ITR filing type for context on quarterly disclosures.

Python: list all three types

import os, requests

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

for doc_type in ("DFP", "ITR", "FRE"):
    r = requests.get(
        f"{BASE}/v1/documents",
        headers=H,
        params={"ticker": "VALE3", "type": doc_type, "year": 2024, "perPage": 10},
    )
    r.raise_for_status()
    total = r.json()["meta"]["total"]
    print(f"VALE3 {doc_type} 2024: {total} document(s)")

Download or extract

Download PDF:

curl -OJ -H "Authorization: Bearer $APICVM_KEY" \
  "$APICVM_URL/v1/documents/<document-id>/file"

Extract text for agents:

curl -X POST -H "Authorization: Bearer $APICVM_KEY" \
  -H "Content-Type: application/json" \
  -d '{"callback_url":"https://your-app.example.com/callbacks/apicvm","document":{"id":"<document-id>"}}' \
  "$APICVM_URL/v1/document-text-extractions"

Current limitations

  • Counts and availability reflect the ingested corpus — new filings appear after pipeline processing.
  • apicvm does not provide commodity prices or production volumes — only CVM regulatory documents.
  • Material facts (Fato Relevante) and IPE are not in the MVP corpus.

Next steps

Ready to integrate?

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

Read the API docs Get API key