public_holidays

ai.dynamicfeed/dynamic-feed · Verify this server

Public / statutory holidays for a country (and optional state/province/region) in a given year — computed in-house, NOT scraped, so it's exact and offline-stable. Per holiday: date, name, weekday, whether it's an observed-day shift, the country, and the subdivision (when one was requested), plus the next upcoming holiday. `country` = ISO-3166 alpha-2 code (default "AU"); common names accepted ("australia", "usa", "uk", "new zealand"). 100+ countries. `year` = 4-digit year (default = current year). `subdiv` = optional subdivision code for region-specific holidays — e.g. "NSW"/"VIC"/"QLD" for AU, "CA"/"NY" for US, "ENG"/"SCT" for GB; national-level only if omitted (state lists are richer). Pairs with `market_hours`. Holiday DATES are non-copyrightable facts; computed via the open-source `holidays` library (vacanza, MIT) — commercial use + redistribution permitted, keyless. Informational only — confirm against the official gazette for legal/payroll use. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observation time) you can verify offline against /.well-known/keys, no account required.