Sources
Every holiday keeps its official reference in source.ref and, when available, a document link in source.url. These are the sources by layer — all public and verifiable.
National and regional holidays
| Source | What it provides |
|---|
| BOE | Annual resolution listing the national public holidays and those of each autonomous community. |
Local holidays (by municipality)
| Source | What it provides |
|---|
| Regional gazettes | Local calendars published by each region (BOJA, DOGC, BOCM, DOGV, BOA…). Format and coverage vary: some gazettes provide names and dates, others dates only, and some municipalities may still be pending ingestion. We use open data where available (e.g. the Generalitat de Catalunya). |
| INE | Municipality dictionary: INE code ↔ name ↔ province ↔ region. The dataset's identification key. |
Population and demographics
| Source | What it provides |
|---|
| INE — Municipal Register | Official municipal revisions at 1 January 2024 and 2025: total population, men and women for all 8,132 INE codes. The latest revision was published on 11 December 2025; /v1/ref/poblacion.json points to that complete municipal revision. |
| INE — Annual Census | Municipal resident population for 2021–2025 by sex, 21 age bands and Spanish/foreign citizenship (table 68535), plus birthplace and mean age (table 68541). The 2025 year was published on 2 December 2025. |
| INE — ECP | Provisional estimate at 1 July 2026, published on 6 August 2026, for Spain, regions, provinces and islands. It does not cover all 8,132 municipalities and does not replace a 2026 municipal register. |
The Municipal Register, Annual Census and ECP are different statistical operations. Their totals and denominators are never mixed: every demographic percentage uses the total from the same Census and year. Own processing using data extracted from the INE website, www.ine.es.
Derived analytics
Holiday Score, rankings, population-weighted means and daily impact are festivos.io's own processing of the published calendars and the Municipal Register revision declared by each output. They are not official INE or gazette statistics. Incomplete calendars remain available but are excluded from rankings; impacts involving the local layer may be lower bounds. See the methodology and observatory.
Tax calendar
| Source | What it provides |
|---|
| AEAT | Taxpayer calendar, ingested from the official iCalendar feeds by tax type (income tax, VAT, corporate tax, informative returns…). Dates already adjusted to working days. |
School calendar
| Source | What it provides |
|---|
| Education departments | The order or resolution for each of the 17 autonomous communities' school calendars (cited with its gazette and date): term start/end, holidays and non-teaching days. Ceuta and Melilla are covered via the Ministry of Education. |
Reuse
Reuse of Spanish public-sector information is governed by Law 37/2007 (cite the source, do not distort its meaning, indicate the update date). festivos.io meets those conditions and passes them on to anyone reusing our data via CC BY 4.0.
License and use →