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.
| Source | What it provides |
|---|---|
| BOE | Annual resolution listing the national public holidays and those of each autonomous community. |
There is no single national source for municipal local holidays. We integrate each region's calendar (official gazette or open-data portal). Format varies: sometimes name and date; sometimes date only ("Festivo local"). Extra proper names are curated innombres-locales.json with a verifiable source — they are not invented. Official publishers per /v1/ref/attribution.json:
| Publisher / source | What it provides |
|---|---|
| Ciudad Autónoma de Ceuta | Fuente: Ciudad Autónoma de Ceuta. Municipal local calendar; coverage and naming follow each year's document. |
| Ciudad Autónoma de Melilla | Fuente: Ciudad Autónoma de Melilla. Municipal local calendar; coverage and naming follow each year's document. |
| Comunidad de Madrid | Fuente: Comunidad de Madrid. Municipal local calendar; coverage and naming follow each year's document. |
| Generalitat de Catalunya — Departament d'Empresa i Treball | Fuente: Generalitat de Catalunya — Departament d'Empresa i Treball. Municipal local calendar; coverage and naming follow each year's document. |
| Generalitat Valenciana | Fuente: Generalitat Valenciana. Municipal local calendar; coverage and naming follow each year's document. |
| Gobierno de Aragón — Aragón Open Data | Fuente: Gobierno de Aragón — Aragón Open Data. CC BY 4.0 (Aragón Open Data). Municipal local calendar; coverage and naming follow each year's document. |
| Gobierno de Canarias | Fuente: Gobierno de Canarias. Municipal local calendar; coverage and naming follow each year's document. |
| Gobierno de Cantabria | Fuente: Gobierno de Cantabria. Municipal local calendar; coverage and naming follow each year's document. |
| Gobierno de La Rioja | Fuente: Gobierno de La Rioja. Municipal local calendar; coverage and naming follow each year's document. |
| Gobierno de Navarra — Nafarroako Gobernua | Fuente: Gobierno de Navarra — Nafarroako Gobernua. Municipal local calendar; coverage and naming follow each year's document. |
| Gobierno del Principado de Asturias | Fuente: Gobierno del Principado de Asturias. Municipal local calendar; coverage and naming follow each year's document. |
| Gobierno Vasco — Eusko Jaurlaritza | Fuente: Gobierno Vasco — Eusko Jaurlaritza. Municipal local calendar; coverage and naming follow each year's document. |
| Govern de les Illes Balears | Fuente: Govern de les Illes Balears. Municipal local calendar; coverage and naming follow each year's document. |
| Junta de Andalucía | Fuente: Junta de Andalucía. Municipal local calendar; coverage and naming follow each year's document. |
| Junta de Castilla y León | Fuente: Junta de Castilla y León. Municipal local calendar; coverage and naming follow each year's document. |
| Junta de Comunidades de Castilla-La Mancha | Fuente: Junta de Comunidades de Castilla-La Mancha. Municipal local calendar; coverage and naming follow each year's document. |
| Junta de Extremadura | Fuente: Junta de Extremadura. Municipal local calendar; coverage and naming follow each year's document. |
| Región de Murcia (CARM) | Fuente: Región de Murcia (CARM). Municipal local calendar; coverage and naming follow each year's document. |
| Xunta de Galicia | Fuente: Xunta de Galicia. Municipal local calendar; coverage and naming follow each year's document. |
| INE | Municipality dictionary: INE code ↔ name ↔ province ↔ region. The dataset's identification key. |
Methodology (named vs generic, indexing and cadence) is on themethodology page.
| 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.
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.
| 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. |
| 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 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.