Foral Data API

Read-only API over Foral's Portuguese municipal data — indicators, municipalities, signals and alerts, in JSON. Base URL: https://data.foral.ai

What you can retrieve

Indicators

Catalogue of municipal indicators, historical series per municipality, a national snapshot with percentiles, and aggregate statistics. Raw values are available on Premium.

Municipalities

Directory of Portuguese municipalities — DICOFRE code, district and NUTS — plus the latest value of every indicator for a given municipality.

Municipal signals

Signals detected in municipal documents (procurement, planning, licensing and more), with evidence, source and dates, plus the cases that group several signals over time.

Alerts

Your own alert rules and the matches found for them, including the AI judge's reasoning. Domain included in Premium.

Key-based authentication (Bearer sk_live_…), cursor pagination, and per-minute rate limits plus a monthly quota set by your plan. Errors are problem+json documents with a stable type URI.

OpenAPI 3.1 specification: https://data.foral.ai/v1/openapi.json