National and regional holidays, plus the local dates currently available for your municipality (INE code). Every published date keeps an official source reference and, when available, a link to the document; missing local coverage is shown explicitly.
8.132
7,212
2024–26
country · region · province · INE
Explore by region
Regional calendars, municipality pages and a transparent local-coverage status for each territory.
What you can ask
From “is today a holiday?” to long weekends and working days — for any of the 8,132 municipality records, using the dates currently published.
An example
Each municipality page shows its holidays, long weekends and the exact status of its local coverage.
For developers
Static dataset (JSON / ICS) under /v1/ and a query layer at the edge. Free, no sign-up or key. Every holiday keeps an official source reference and, when available, a document link.
# Is 19 August 2026 a public holiday in Tarragona? curl "https://api.festivos.io/v1/is-holiday?date=2026-08-19&municipio=43148" # → holiday: true · “Sant Magí” (local) · source: Generalitat/DOGC
For agents and AI
An MCP server exposes the holidays as tools: the agent understands the municipality name and answers in natural language, without you knowing the INE code.
# Terminal · any MCP client via remote URL
claude mcp add --transport sse festivos https://mcp.festivos.io/sseAsk it: “Do I work tomorrow in Sabadell?” · “Long weekends in Barcelona 2026?”
Transparency
National and regional layers come from the BOE and regional resolutions. Local data is integrated region by region; current and historical gaps are reported instead of inferred.
88.7%
52.4%
84%
69.9%
FAQ
Yes: free, no sign-up or key. Data under CC BY 4.0 (cite the source). Static files over CDN, with no practical limits.
For 2026, national and regional holidays are present for every municipality; local dates are present for 7,212 of 8,132 municipalities (88.7%). Named, generic and missing local records are reported separately on the coverage page.
Usually around 14, combining national, regional and up to two local dates designated for that municipality. The exact figure and the dataset's local availability depend on the municipality and year.
National holidays apply across Spain; regional holidays apply in one autonomous community; local holidays apply only in a municipality and are generally designated up to two per year.
A working day wedged between two non-working days (or next to a holiday and the weekend) that people usually take off. festivos.io detects them per municipality.
Every municipality has a year-specific .ics link for Google Calendar, Apple Calendar or Outlook. It reflects corrections to that published year; switch to the next year's URL when required.
Where the gazette publishes them, yes. Where only dates exist, we add verified names for capitals and notable municipalities; the rest grows by Pull Request.
It's still marked. Some national holidays move to the Monday by law, and we reflect that when the BOE indicates it.
From the BOE, regional gazettes, the INE and the AEAT. Each date keeps an official reference and, when available, a document link. We don't replace the official gazette — verify it for legal decisions.
Spanish and, in its territory, the co-official language (Catalan, Galician, Basque, Valencian), plus English. Each version with its URL and hreflang.