Skip to main content
PT FR / API · Portugal

Build on Portugal filings programmatically.

A typed REST API over 9,332 filings from 52 Portuguese listed companies — JSON metadata, Markdown body, and original PDF. Webhooks on every new release.

Public-company filings in Portugal are supervised by Comissão do Mercado de Valores Mobiliários (CMVM). Reporting follows IFRS. Filings are most commonly published in Portuguese and English. Major issuers are listed on PSI 20 and PSI. Calendar year.

Integrating Portuguese filings into your pipeline

The FinancialReports API delivers CMVM-supervised Portuguese filings through the same single REST surface, one x-api-key header, and one shared rate-limit bucket used across all 42 covered markets. A Portugal-only integration is a one-parameter filter (?country=PT) on the global filings endpoint — no separate Portuguese API key, no additional billing, and no per-country infrastructure. PSI 20 annual reports, CMVM ad-hoc announcements, and Euronext Lisbon admission documents are all served from the same endpoint.

For live pipelines the webhook channel delivers full filing metadata within roughly 60 seconds of CMVM or Euronext Lisbon publication. The payload shape is identical across all covered markets — a Portuguese MAR Article 17 announcement arrives with the same JSON envelope as a Spanish CNMV filing or a French AMF press release. For Iberian integrations, combining ?country=PT and ?country=ES in the same subscriber configuration delivers Portuguese and Spanish filings through one webhook endpoint with country metadata for downstream routing — useful when tracking EDP or Galp, which file in both markets.

Filing bodies are available as JSON metadata, Markdown via /api/filings/{id}/markdown/, and original PDF or iXBRL. The bilingual filing environment — Portuguese and English versions for most PSI 20 issuers — is reflected in separate filing records per language version with language metadata in the JSON payload, enabling consumers to select the preferred language without document-level inspection. iXBRL is preserved for ESEF-mandated annual reports, retaining machine-readable financial line-items where the regulator requires them.

Common API integrations for Portuguese data include backfilling PSI 20 consolidated financials for quant research (particularly EDP, EDP Renováveis, and Galp for renewable-energy and integrated-energy sector models), triggering on ad-hoc disclosures from cross-listed issuers such as EDP, monitoring MAR Article 19 insider-transaction notifications, combining the Portuguese and Spanish feeds for Iberian portfolio models, and feeding bilingual Portuguese-English filings into NLP pipelines targeting Southern European markets. Trial keys are available on request; the web product is free and indexed for the public web.

Filings indexed
9,332
in Portugal
Listed companies
52
Portuguese issuers
Auth
x-api-key
single header
Webhook latency
< 1 min
from regulator publish

Reporting at a glance — Portugal

Regulator, indices, accounting, language
Primary indices
PSI 20PSI
Accounting standards
IFRS
Reporting languages
PortugueseEnglish
Fiscal year
Calendar year

Quick start — Portugal filings

REST · JSON · Markdown · PDF
# 1. List filings for Portugal, newest first
curl "https://api.financialreports.eu/api/filings/?countries=PT" \
    -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=PT&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 Portugal response

Real filings · live data

Get API access for Portugal

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

Filings activity by year

Last 6 years · Portuguese issuers
  • 2026 120
  • 2025 594
  • 2024 615
  • 2023 537
  • 2022 556
  • 2021 574

Reporting languages

Filing-by-filing distribution
  • English 9,225
  • Portuguese 105
  • Russian 1
  • Spanish 1

FAQ — Portugal

Coverage, formats, integration
How do I authenticate API requests for Portugal 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 Portugal 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 Portuguese 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 Portuguese 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 Portugal 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.