Printable Calendar Maker

Find public holidays

find_holidays

Read-onlyIdempotent

Use this when the user wants the list of public holidays for a country (and optionally a state or region) in a year, for example to check what a printed calendar will mark ("bank holidays 2027 UK", "Texas holidays 2027", "Feiertage Bayern 2027"). Returns each holiday with its date, weekday and type, including observed weekdays when a holiday falls on a weekend; observances are optional. Does not count business days between dates, and does not cover school terms or religious calendars outside the holiday data.

Input Schema

TableJSON Schema

Name	Required	Description
`year`	No	Year, e.g. 2027. Default: next year from October on, otherwise this year.
`country`	Yes	Country: ISO two-letter code or name, e.g. US, GB, DE, PL, FR, JP, BR, AU, CA.
`language`	No	Language for month and weekday names: en (default), pl, de, es, fr, it, pt, nl or ja. Holiday names use this language when the country's data has it, else English. Example: de
`subdivision`	No	Optional state, province or region for local holidays, e.g. TX or CA (US), BY (Bavaria, DE), SCT (Scotland), NSW (AU), ON (CA).
`include_observances`	No	Also show observances, bank and optional days (e.g. Mother's Day, Valentine's Day, Christmas Eve). Default false: public holidays only.