{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"global-public-holiday-add-working-days"},"result":{"entity_type":"calculator","id":"global-public-holiday-add-working-days","calculator_id":"global-public-holiday-add-working-days","canonical_url":"https://tttkmbb.com/everyday/global-public-holiday-add-working-days","name":"Add Global Public-Holiday Reference Working Days","title":"Add Global Public-Holiday Reference Working Days – OpenHolidays","category":"everyday","category_name":"Everyday Life","tool_name":"add_global_public_holiday_working_days","featured_mcp_tool":true,"description":"Adds or subtracts working days using the pinned OpenHolidays nationwide public-holiday reference and CLDR weekend rule for a supported country.","use_when":"You need a 2026-2028 date offset and accept the OpenHolidays nationwide-only, no-inferred-substitute-day reference semantics.","do_not_use_when":"The task requires a direct official authority, regional/local or employer calendar, substitute-day rules, or dates outside the published coverage.","agent_examples":["Add five reference working days to 2026-10-23 in Austria."],"inputs":[{"name":"start_date","label":"Start date","type":"date","required":true,"description":"Gregorian start date in 2026-2028.","example":"2026-10-23"},{"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"},{"name":"working_days","label":"Working days","type":"integer","unit":"working days","required":true,"min":-1000,"max":1000,"description":"Signed offset; the start date is excluded for non-zero offsets.","example":5}],"outputs":[{"name":"start_date","label":"Start date","type":"date","decimals":4,"description":"Input date."},{"name":"result_date","label":"Result date","type":"date","decimals":4,"description":"Date reached."},{"name":"working_days_added","label":"Working days added","type":"integer","unit":"working days","decimals":4,"description":"Signed requested offset."},{"name":"calendar_days_elapsed","label":"Calendar days elapsed","type":"integer","unit":"days","decimals":4,"description":"Signed Gregorian difference."},{"name":"non_working_weekend_days_skipped","label":"Weekend days skipped","type":"integer","unit":"days","decimals":4,"description":"Weekend dates crossed."},{"name":"public_holidays_skipped","label":"Public holidays skipped","type":"list","decimals":4,"description":"Included nationwide public-holiday events crossed."},{"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":"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":{"start_date":{"description":"Gregorian start date in 2026-2028.","type":"string","format":"date","examples":["2026-10-23"]},"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},"working_days":{"description":"Signed offset; the start date is excluded for non-zero offsets. Unit: working days.","type":"integer","minimum":-1000,"maximum":1000,"examples":[5],"x-unit":"working days"}},"additionalProperties":false,"required":["start_date","territory","working_days"],"examples":[{"start_date":"2026-10-23","territory":"AT","working_days":5}]},"output_schema":{"type":"object","properties":{"start_date":{"description":"Input date.","type":"string","format":"date"},"result_date":{"description":"Date reached.","type":"string","format":"date"},"working_days_added":{"description":"Signed requested offset. Unit: working days.","type":"integer","x-unit":"working days"},"calendar_days_elapsed":{"description":"Signed Gregorian difference. Unit: days.","type":"integer","x-unit":"days"},"non_working_weekend_days_skipped":{"description":"Weekend dates crossed. Unit: days.","type":"integer","x-unit":"days"},"public_holidays_skipped":{"description":"Included nationwide public-holiday events crossed.","type":"array"},"territory":{"description":"Normalized uppercase country code.","type":"string"},"territory_name":{"description":"English country name from the source catalogue.","type":"string"},"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":"move one Gregorian day at a time; decrement remaining only when the reference status is_working_day=true","method":"The start date is excluded for non-zero offsets. Weekend and included nationwide public-holiday dates are skipped; substitute days are not inferred.","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."},"examples":[{"name":"Austria offset across National Day","inputs":{"start_date":"2026-10-23","territory":"AT","working_days":5},"expected":{"result_date":"2026-11-02"},"url":"https://tttkmbb.com/api/v1/calculate/global-public-holiday-add-working-days?start_date=2026-10-23&territory=AT&working_days=5"}],"faq":[{"q":"What if the offset crosses the snapshot boundary?","a":"The call fails with OUT_OF_RANGE rather than extrapolating."},{"q":"Are substitute days inferred?","a":"This reference package includes only nationwide public events from OpenHolidays for 2026-2028. It excludes regional/local holidays, substitute-day inference, employer, bank, exchange, school, religious and emergency closures. Verify material legal, payroll, banking or settlement decisions against the responsible authority."}],"tags":["add global working days","public holiday reference","OpenHolidays deadline"],"related":[{"calculator_id":"global-public-holiday-working-day","reason":"Inspect the source-labelled status of one date."},{"calculator_id":"global-working-days-between","reason":"Count reference working days in a range."}],"links":{"html":"https://tttkmbb.com/everyday/global-public-holiday-add-working-days","markdown":"https://tttkmbb.com/everyday/global-public-holiday-add-working-days.md","json":"https://tttkmbb.com/everyday/global-public-holiday-add-working-days.json","api":"https://tttkmbb.com/api/v1/calculate/global-public-holiday-add-working-days","schema":"https://tttkmbb.com/api/v1/calculators/global-public-holiday-add-working-days","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-27"},"timestamp":"2026-09-28T19:06:00Z","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-add-working-days","markdown":"https://tttkmbb.com/everyday/global-public-holiday-add-working-days.md","api":"https://tttkmbb.com/api/v1/calculate/global-public-holiday-add-working-days"}}