v0.1.2

api.ptdata.org

Unified Portuguese Government Open Data API. Aggregates, normalizes, and cross-references data from official sources into a clean REST API.

Geografia

Districts, municipalities, parishes, NUTS regions. Full CAOP 2025 + Censos 2021 population.

Meteorologia

IPMA weather forecasts, 221 station observations, and active meteorological warnings.

Contratos Publicos

Public procurement contracts from BASE/IMPIC. Prices, entities, suppliers, CPV codes.

Protecao Civil

Real-time occurrences, historical fire records (ICNF), fire risk indices. SSE live stream.

Economia

Exchange rates (EUR), ECB interest rates, CPI/GDP/unemployment indicators, housing prices. Banco de Portugal (BPstat).

Fiscal

NIF/NIPC validation, VAT rates by region, and invoice data validation (NIF checksum, VAT calculation, totals).

Algorithmic + invoice validation

MCP Server (AI Agents)

Native Model Context Protocol endpoint. Connect Claude, GPTs, or any MCP-compatible AI agent to query Portuguese government data directly.

{"mcpServers": {"ptdata": {"type": "url", "url": "https://api.ptdata.org/mcp"}}}

21 tools: geography, weather, civil protection, contracts, economy, fiscal, invoice validation

Quick start

curl https://api.ptdata.org/v1 curl https://api.ptdata.org/v1/geo/districts curl https://api.ptdata.org/v1/weather/warnings curl https://api.ptdata.org/v1/contracts?year=2026&limit=5 curl https://api.ptdata.org/v1/economy/exchange-rates curl https://api.ptdata.org/v1/fiscal/nif/500000000 curl https://api.ptdata.org/v1/companies/500000018 # Validate invoice — 16 checks, 4 data sources (POST)
curl -X POST https://api.ptdata.org/v1/fiscal/invoices/validate \
-H "Content-Type: application/json" \
-d '{"supplier_nif":"500000018","invoice_number":"FT A/123","invoice_date":"2026-04-01","atcud":"ABCD1234-123","subtotal":100,"vat_rate":23,"vat_amount":23,"total":123}'