{"slug":"2s-io-api-calendar-holidays-c88fed","title":"List the official holidays for a country and year, with exact observed dates inc","host":"2s.io","method":"GET","resource":"https://2s.io/api/calendar/holidays","category":"code","description":"List the official holidays for a country and year, with exact observed dates including substitute days (e.g. a Saturday July 4th observed on Friday). Query: country (ISO 3166-1 alpha-2, 200+ supported), year, optional region (subdivision code like CA for US-California or BY for DE-Bavaria), optional","price_listed":0.0025,"price_asked":0.0025,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":397,"reported_calls_30d":5,"reported_payers_30d":3,"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"country":"US","types":"public","year":"2026"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"properties":{"method":{"const":"GET"},"queryParams":{"properties":{"country":{"description":"ISO 3166-1 alpha-2 country code, e.g. US, DE, JP.","type":"string"},"lang":{"description":"Optional ISO 639-1 language for holiday names.","type":"string"},"region":{"description":"Optional subdivision code, e.g. CA (US-California), BY (DE-Bavaria).","type":"string"},"types":{"description":"Optional comma-separated filter: public, bank, school, optional, observance.","type":"string"},"year":{"description":"Calendar year, e.g. 2026.","type":"string"}},"required":["country","year"]},"type":{"const":"http"}},"required":["type","method","queryParams"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.0025,"price_match":true,"latency_ms":397,"error":null}],"description_full":"List the official holidays for a country and year, with exact observed dates including substitute days (e.g. a Saturday July 4th observed on Friday). Query: country (ISO 3166-1 alpha-2, 200+ supported), year, optional region (subdivision code like CA for US-California or BY for DE-Bavaria), optional types filter (public, bank, school, optional, observance — comma-separated), optional lang (ISO 639-1) for localized names. Returns one item per holiday: { date (YYYY-MM-DD), name, type, substitute, rule }. Dates are computed from maintained per-country rules — including movable feasts and lunar-calendar holidays — so they stay correct year over year. Use for scheduling, delivery estimates, payment terms, and SLA math.","last_updated":"2026-09-09T16:16:59.919Z","schemes":["exact"]}