{"openapi":"3.1.0","info":{"title":"Holidays API","version":"0.1.0","description":"Public holidays of about 200 countries and their states or regions, whether a date is a holiday, and business days between two dates (custom weekends supported). Substitute (observed) days are included and flagged. 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/holidays":{"get":{"summary":"Supported countries","security":[{"licence":[]}],"parameters":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid country, region, year, date or option; the body says which."},"402":{"description":"Payment required: no valid licence. The body names the plan and where to buy it."},"403":{"description":"Invented or revoked licence."}}}},"/v1/holidays/{country}/regions":{"get":{"summary":"States or regions of a country","security":[{"licence":[]}],"parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string","example":"US"},"description":"ISO 3166-1 alpha-2 code"}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid country, region, year, date or option; the body says which."},"402":{"description":"Payment required: no valid licence. The body names the plan and where to buy it."},"403":{"description":"Invented or revoked licence."}}}},"/v1/holidays/{country}/{year}":{"get":{"summary":"Holidays of a country in a year","security":[{"licence":[]}],"parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string","example":"US"},"description":"ISO 3166-1 alpha-2 code"},{"name":"year","in":"path","required":true,"schema":{"type":"string","example":"2026"},"description":"1970 to 2100"},{"name":"region","in":"query","required":false,"schema":{"type":"string","example":"CA"},"description":"State or region code (see /v1/holidays/{country}/regions)"},{"name":"types","in":"query","required":false,"schema":{"type":"string","example":"public"},"description":"Comma-separated: public, bank, school, optional, observance. Default: public"}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid country, region, year, date or option; the body says which."},"402":{"description":"Payment required: no valid licence. The body names the plan and where to buy it."},"403":{"description":"Invented or revoked licence."}}}},"/v1/holidays/is-holiday/{country}/{date}":{"get":{"summary":"Whether a date is a holiday","security":[{"licence":[]}],"parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string","example":"GB"},"description":"ISO 3166-1 alpha-2 code"},{"name":"date","in":"path","required":true,"schema":{"type":"string","example":"2026-12-28"},"description":"YYYY-MM-DD"},{"name":"region","in":"query","required":false,"schema":{"type":"string","example":"CA"},"description":"State or region code (see /v1/holidays/{country}/regions)"},{"name":"types","in":"query","required":false,"schema":{"type":"string","example":"public"},"description":"Comma-separated: public, bank, school, optional, observance. Default: public"}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid country, region, year, date or option; the body says which."},"402":{"description":"Payment required: no valid licence. The body names the plan and where to buy it."},"403":{"description":"Invented or revoked licence."}}}},"/v1/holidays/business-days/{country}/{from}/{to}":{"get":{"summary":"Business days between two dates, both included","security":[{"licence":[]}],"parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string","example":"US"},"description":"ISO 3166-1 alpha-2 code"},{"name":"from","in":"path","required":true,"schema":{"type":"string","example":"2026-07-01"},"description":"YYYY-MM-DD"},{"name":"to","in":"path","required":true,"schema":{"type":"string","example":"2026-07-31"},"description":"YYYY-MM-DD"},{"name":"region","in":"query","required":false,"schema":{"type":"string","example":"CA"},"description":"State or region code (see /v1/holidays/{country}/regions)"},{"name":"types","in":"query","required":false,"schema":{"type":"string","example":"public"},"description":"Comma-separated: public, bank, school, optional, observance. Default: public"},{"name":"weekend","in":"query","required":false,"schema":{"type":"string","example":"sat,sun"},"description":"Weekend days, comma-separated (sun…sat). Default: sat,sun"}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid country, region, year, date or option; the body says which."},"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"}}}}}}