{"openapi":"3.1.0","info":{"title":"Festivos ES","version":"0.1.0","description":"Spanish public holidays by autonomous community, whether a date is a holiday, and working days between two dates. Listing follows the BOE annual resolution: holidays on a Sunday are not listed, substitute days are. Data: date-holidays (CC BY-SA 4.0); every response carries its source. Paid routes need a LicenRoute licence (Authorization: Bearer bgat_…)."},"components":{"securitySchemes":{"licence":{"type":"http","scheme":"bearer","description":"LicenRoute licence key (bgat_…)"}}},"paths":{"/v1/calendar":{"get":{"summary":"List region codes","security":[{"licence":[]}],"parameters":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid year, date or region code."},"402":{"description":"Payment required: no valid licence. The body names the plan and where to buy it."},"403":{"description":"Invented or revoked licence."}}}},"/v1/calendar/holidays/{year}":{"get":{"summary":"National public holidays of a year","security":[{"licence":[]}],"parameters":[{"name":"year","in":"path","required":true,"schema":{"type":"string","example":"2026"},"description":"2000 to 2100"}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid year, date or region code."},"402":{"description":"Payment required: no valid licence. The body names the plan and where to buy it."},"403":{"description":"Invented or revoked licence."}}}},"/v1/calendar/holidays/{year}/{region}":{"get":{"summary":"National and regional public holidays of a year","security":[{"licence":[]}],"parameters":[{"name":"year","in":"path","required":true,"schema":{"type":"string","example":"2026"},"description":"2000 to 2100"},{"name":"region","in":"path","required":true,"schema":{"type":"string","example":"MD"},"description":"Region code"}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid year, date or region code."},"402":{"description":"Payment required: no valid licence. The body names the plan and where to buy it."},"403":{"description":"Invented or revoked licence."}}}},"/v1/calendar/is-holiday/{date}":{"get":{"summary":"Whether a date is a public holiday","security":[{"licence":[]}],"parameters":[{"name":"date","in":"path","required":true,"schema":{"type":"string","example":"2026-09-11"},"description":"YYYY-MM-DD"},{"name":"region","in":"query","required":false,"schema":{"type":"string","example":"MD"},"description":"Region code (see /v1/calendar). Without it: national holidays only."}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid year, date or region code."},"402":{"description":"Payment required: no valid licence. The body names the plan and where to buy it."},"403":{"description":"Invented or revoked licence."}}}},"/v1/calendar/working-days/{from}/{to}":{"get":{"summary":"Working days (Monday to Friday, not a holiday) between two dates, both included","security":[{"licence":[]}],"parameters":[{"name":"from","in":"path","required":true,"schema":{"type":"string","example":"2026-04-01"},"description":"YYYY-MM-DD"},{"name":"to","in":"path","required":true,"schema":{"type":"string","example":"2026-04-30"},"description":"YYYY-MM-DD"},{"name":"region","in":"query","required":false,"schema":{"type":"string","example":"MD"},"description":"Region code (see /v1/calendar). Without it: national holidays only."}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid year, date or region code."},"402":{"description":"Payment required: no valid licence. The body names the plan and where to buy it."},"403":{"description":"Invented or revoked licence."}}}},"/health":{"get":{"summary":"Health check (free)","responses":{"200":{"description":"OK"}}}}}}