databutler-calendar

Public holidays, tax-year dates or daylight-saving switches for one country in 2026–2028, from the official lists and statutes. kind=holidays (uk, us, de, fr): every public holiday of the year with its date and weekday, by region — UK nations (england-and-wales, scotland, northern-ireland; substitute days flagged), US federal (statutory date plus OPM's observed date when it falls on a weekend), German Länder by code or name (nationwide = the nine bundeseinheitlichen Feiertage; partial holidays carry their scope), French metropole or alsace-moselle. kind=tax-year (uk, us, au, in, ca, de, fr, br, pl): the personal tax year's start and end with the periods for 2026–2028 and the statute or official page quoted, plus the government fiscal year where it differs. kind=dst (uk, de, fr, us, au, br): the statutory rule and the computed clocks-forward and clocks-back dates per year, with the states that observe it for Australia and observed:false for Brazil. Country names, UK nations, German Land names (Bavaria, Sachsen) and kind synonyms (bank holidays, financial year, clocks) resolve; no country lists everything covered; unknown countries, regions and years answer covered:false with the nearest matches. Entries that could not be re-verified against an official page carry nonOfficial: true.

{'type': 'object', 'properties': {'kind': {'enum': ['holidays', 'tax-year', 'dst'], 'type': 'string', 'description': 'holidays | tax-year | dst (synonyms accepted: bank holidays, financial year, daylight saving)'}, 'year': {'type': 'integer', 'description': '2026–2028; holidays default to the current year, tax-year and dst to all years covered'}, 'region': {'type': 'string', 'description': 'UK: england-and-wales | scotland | northern-ireland; US: federal; Germany: nationwide or a Land (BY, Bayern, Bavaria, …); France: metropole | alsace-moselle'}, 'country': {'type': 'string', 'description': 'one of uk, us, de, fr, au, in, ca, br, pl, or a name (United Kingdom, Germany, Bavaria resolves to de with region BY); omit to list'}}}

The next public holiday strictly after a date (default: today) for uk, us, de, fr, with its name, date, weekday and days until it, the three that follow, and any holiday falling on the date itself; by region as for calendar_facts (UK nations, US federal with OPM's observed date deciding the order, German Länder, French zones). The data runs to the end of 2028; a later date answers covered:false with the last date covered. From the same monthly snapshot of the official lists, with the list's URL as source.

{'type': 'object', 'required': ['country'], 'properties': {'from': {'type': 'string', 'description': 'ISO date YYYY-MM-DD; the next holiday is the first one after this day (default: today)'}, 'region': {'type': 'string', 'description': 'as for calendar_facts (default: england-and-wales, federal, nationwide, metropole)'}, 'country': {'type': 'string', 'description': 'one of uk, us, de, fr, or a name'}}}