// apis / holidayatlas

HolidayAtlas

Which holidays apply to a postal code? HolidayAtlas answers that, holiday by holiday, with the legal source cited (BOE or regional gazette). Built for payroll and HR, e-commerce and logistics, and shift planning software.

• Postal code granularity: when a code crosses more than one municipality, it says so honestly, with weighted candidates (s'Arenal, 07600: Palma 66%, Llucmajor 34%).
• A legal source on every entry: each holiday cites the BOE or regional gazette it comes from. No more lists with no guarantee.
• Village-level holidays: in the Balearics, 19 municipalities vary by village or parish. Covered too.
• Corrections tracked: official calendars keep getting corrected for months (the 2026 Balearic one had four). All applied and cited.

Current coverage: the whole Balearic Islands, year 2026 (67 municipalities, 106 zones). All of Spain and more countries on the roadmap.

Try it

The API is public for evaluation: base URL, OpenAPI spec and coverage index.

Licence and terms

The database belongs to Apiverd and is protected as a database (sui generis right, Directive 96/9/EC). Querying and evaluating it is free; redistributing the dataset or using it commercially requires a licence: admin@apiverd.com.

Data compiled with the utmost care, with a legal source on every entry. For critical uses, check the cited source.

Postal mapping: CartoCiudad © Instituto Geográfico Nacional de España, CC-BY 4.0.