{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"global-public-holiday-working-day"},"result":{"entity_type":"calculator","id":"global-public-holiday-working-day","calculator_id":"global-public-holiday-working-day","canonical_url":"https://tttkmbb.com/everyday/global-public-holiday-working-day","name":"Global Public-Holiday Working Day Reference","title":"Global Public-Holiday Working Day Reference – OpenHolidays","category":"everyday","category_name":"Everyday Life","tool_name":"check_global_public_holiday_working_day","featured_mcp_tool":true,"description":"Checks a date for a supported country using CLDR weekend rules plus nationwide public-holiday events from a pinned OpenHolidays open-data snapshot, with explicit non-authority and substitute-day limits.","use_when":"You need a source-labelled 2026-2028 public-holiday reference for one of the supported OpenHolidays countries and nationwide-only semantics are acceptable.","do_not_use_when":"You need an official direct authority result, regional/local holidays, substitute-day rules, employer/bank/exchange closures, or a date outside 2026-2028; use the verified China/UK package or the CLDR baseline as appropriate.","agent_examples":["Is 2026-10-26 a working day in Austria after nationwide public holidays are excluded?","Check 2027-05-01 in France using the OpenHolidays nationwide reference."],"inputs":[{"name":"date","label":"Date","type":"date","required":true,"description":"Gregorian date from 2026-01-01 through 2028-12-31.","example":"2026-10-26"},{"name":"territory","label":"Country","type":"enum","required":true,"values":[{"value":"AD","label":"AD"},{"value":"AL","label":"AL"},{"value":"AT","label":"AT"},{"value":"BE","label":"BE"},{"value":"BG","label":"BG"},{"value":"BY","label":"BY"},{"value":"CH","label":"CH"},{"value":"CZ","label":"CZ"},{"value":"DE","label":"DE"},{"value":"EE","label":"EE"},{"value":"ES","label":"ES"},{"value":"FR","label":"FR"},{"value":"HR","label":"HR"},{"value":"HU","label":"HU"},{"value":"IE","label":"IE"},{"value":"IT","label":"IT"},{"value":"LI","label":"LI"},{"value":"LT","label":"LT"},{"value":"LU","label":"LU"},{"value":"LV","label":"LV"},{"value":"MC","label":"MC"},{"value":"MD","label":"MD"},{"value":"MT","label":"MT"},{"value":"MX","label":"MX"},{"value":"NL","label":"NL"},{"value":"PL","label":"PL"},{"value":"PT","label":"PT"},{"value":"RO","label":"RO"},{"value":"RS","label":"RS"},{"value":"SE","label":"SE"},{"value":"SI","label":"SI"},{"value":"SK","label":"SK"},{"value":"SM","label":"SM"},{"value":"VA","label":"VA"},{"value":"ZA","label":"ZA"}],"description":"ISO-style alpha-2 country code supported by the pinned OpenHolidays public-holiday reference snapshot.","example":"DE"}],"outputs":[{"name":"territory","label":"Country","type":"string","decimals":4,"description":"Normalized uppercase country code."},{"name":"territory_name","label":"Country name","type":"string","decimals":4,"description":"English country name from the source catalogue."},{"name":"weekday","label":"Weekday","type":"string","decimals":4,"description":"Gregorian weekday."},{"name":"is_working_day","label":"Working day","type":"boolean","decimals":4,"description":"True when the date is outside the CLDR weekend and has no included nationwide public-holiday event."},{"name":"weekend_days","label":"Weekend days","type":"string_list","decimals":4,"description":"CLDR weekend convention used as the base rule."},{"name":"holiday_names","label":"Public holidays","type":"string_list","decimals":4,"description":"Included nationwide public-holiday names on the date."},{"name":"holiday_policy","label":"Holiday policy","type":"string","decimals":4,"description":"Nationwide public events only; regional and substitute-day rules are not inferred."},{"name":"calendar_scope","label":"Calendar scope","type":"string","decimals":4,"description":"Weekday plus nationwide public-holiday reference."},{"name":"calendar_profile","label":"Calendar profile","type":"string","decimals":4,"description":"global-public-holiday-reference."},{"name":"substitute_day_policy","label":"Substitute-day policy","type":"string","decimals":4,"description":"not_inferred."},{"name":"source_quality","label":"Source quality","type":"string","decimals":4,"description":"Open public-source aggregation, not a direct national authority feed."},{"name":"dataset_version","label":"Dataset version","type":"string","decimals":4,"description":"Pinned OpenHolidays snapshot version."},{"name":"coverage_start","label":"Coverage start","type":"date","decimals":4,"description":"First supported date."},{"name":"coverage_end","label":"Coverage end","type":"date","decimals":4,"description":"Last supported date."},{"name":"source_commit","label":"Source commit","type":"string","decimals":4,"description":"Immutable source-data repository commit."}],"input_schema":{"type":"object","properties":{"date":{"description":"Gregorian date from 2026-01-01 through 2028-12-31.","type":"string","format":"date","examples":["2026-10-26"]},"territory":{"description":"ISO-style alpha-2 country code supported by the pinned OpenHolidays public-holiday reference snapshot.","type":"string","enum":["AD","AL","AT","BE","BG","BY","CH","CZ","DE","EE","ES","FR","HR","HU","IE","IT","LI","LT","LU","LV","MC","MD","MT","MX","NL","PL","PT","RO","RS","SE","SI","SK","SM","VA","ZA"],"examples":["DE"],"pattern":"^[A-Z]{2}$","maxLength":2}},"additionalProperties":false,"required":["date","territory"],"examples":[{"date":"2026-10-26","territory":"AT"}]},"output_schema":{"type":"object","properties":{"territory":{"description":"Normalized uppercase country code.","type":"string"},"territory_name":{"description":"English country name from the source catalogue.","type":"string"},"weekday":{"description":"Gregorian weekday.","type":"string"},"is_working_day":{"description":"True when the date is outside the CLDR weekend and has no included nationwide public-holiday event.","type":"boolean"},"weekend_days":{"description":"CLDR weekend convention used as the base rule.","type":"array","items":{"type":"string"}},"holiday_names":{"description":"Included nationwide public-holiday names on the date.","type":"array","items":{"type":"string"}},"holiday_policy":{"description":"Nationwide public events only; regional and substitute-day rules are not inferred.","type":"string"},"calendar_scope":{"description":"Weekday plus nationwide public-holiday reference.","type":"string"},"calendar_profile":{"description":"global-public-holiday-reference.","type":"string"},"substitute_day_policy":{"description":"not_inferred.","type":"string"},"source_quality":{"description":"Open public-source aggregation, not a direct national authority feed.","type":"string"},"dataset_version":{"description":"Pinned OpenHolidays snapshot version.","type":"string"},"coverage_start":{"description":"First supported date.","type":"string","format":"date"},"coverage_end":{"description":"Last supported date.","type":"string","format":"date"},"source_commit":{"description":"Immutable source-data repository commit.","type":"string"}}},"formula":"is_working_day = CLDR weekday(date) and no included nationwide public-holiday event(date, territory)","method":"Resolve the CLDR weekend rule and compare the date with the pinned nationwide Public events. Regional events and observed/substitute rules are not added unless the source explicitly lists them as events.","sources":[{"name":"OpenHolidays API public-holiday data","url":"https://openholidaysapi.org/PublicHolidays","type":"open_data_aggregation","retrieved_at":"2026-09-29","licence":"ODbL-1.0","licence_url":"https://opendatacommons.org/licenses/odbl/1-0/","note":"Public-source aggregation; only nationwide Public events are included. Regional events, substitute-day inference and non-public observances are excluded."}],"freshness":{"type":"static","max_age_seconds":null,"note":"Pinned OpenHolidays 2026-2028 snapshot; data updates require an explicit source review and candidate release."},"examples":[{"name":"Austria National Day","inputs":{"date":"2026-10-26","territory":"AT"},"expected":{"is_working_day":false,"holiday_names":["National Day"]},"url":"https://tttkmbb.com/api/v1/calculate/global-public-holiday-working-day?date=2026-10-26&territory=AT"}],"faq":[{"q":"Is this an official national calendar?","a":"No. It is an open public-source aggregation with explicit provenance; verify material decisions against the responsible authority."},{"q":"Does it include substitute days?","a":"No substitute-day rule is inferred. The result returns substitute_day_policy=not_inferred."},{"q":"Does it include regional holidays?","a":"No. Only events marked nationwide by the snapshot are included."}],"tags":["global working day","public holiday reference","OpenHolidays","nationwide holiday","business day"],"related":[{"calculator_id":"global-working-day","reason":"Use for any CLDR territory when only weekend semantics are required."},{"calculator_id":"china-working-day","reason":"Use the official mainland China package when China holidays and 调休 matter."},{"calculator_id":"uk-working-day","reason":"Use the official GOV.UK division package for UK bank holidays."}],"links":{"html":"https://tttkmbb.com/everyday/global-public-holiday-working-day","markdown":"https://tttkmbb.com/everyday/global-public-holiday-working-day.md","json":"https://tttkmbb.com/everyday/global-public-holiday-working-day.json","api":"https://tttkmbb.com/api/v1/calculate/global-public-holiday-working-day","schema":"https://tttkmbb.com/api/v1/calculators/global-public-holiday-working-day","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-27"},"timestamp":"2026-09-28T19:05:17Z","links":{"mcp":"https://tttkmbb.com/mcp","a2a":"https://tttkmbb.com/a2a","openapi":"https://tttkmbb.com/openapi.json","llms_txt":"https://tttkmbb.com/llms.txt","feed":"https://tttkmbb.com/feed.xml","ard":"https://tttkmbb.com/.well-known/ard.json","ai_catalog":"https://tttkmbb.com/.well-known/ai-catalog.json","agent_card":"https://tttkmbb.com/.well-known/agent-card.json","mcp_server_card":"https://tttkmbb.com/mcp/server-card","mcp_server_card_legacy":"https://tttkmbb.com/.well-known/mcp-server-card.json","ai_plugin":"https://tttkmbb.com/.well-known/ai-plugin.json","agent_capabilities":"https://tttkmbb.com/agent-capabilities.json","docs":"https://tttkmbb.com/docs/index.md","privacy":"https://tttkmbb.com/docs/privacy","terms":"https://tttkmbb.com/docs/terms","support":"https://tttkmbb.com/docs/support","china_work_calendar_data":"https://tttkmbb.com/api/v1/data/china-work-calendar/2026","uk_bank_holidays_data":"https://tttkmbb.com/api/v1/data/uk-bank-holidays","iana_tzdb_data":"https://tttkmbb.com/api/v1/data/iana-tzdb","global_working_day_data":"https://tttkmbb.com/api/v1/data/global-working-day","global_public_holiday_data":"https://tttkmbb.com/api/v1/data/global-public-holidays","global_working_day_reference_data":"https://tttkmbb.com/api/v1/data/global-working-day-reference","working_day_catalog":"https://tttkmbb.com/api/v1/data/working-day-calendars","html":"https://tttkmbb.com/everyday/global-public-holiday-working-day","markdown":"https://tttkmbb.com/everyday/global-public-holiday-working-day.md","api":"https://tttkmbb.com/api/v1/calculate/global-public-holiday-working-day"}}