{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"global-reference-add-working-days"},"result":{"entity_type":"calculator","id":"global-reference-add-working-days","calculator_id":"global-reference-add-working-days","canonical_url":"https://tttkmbb.com/everyday/global-reference-add-working-days","name":"Add Global Reference Working Days","title":"Add Global Reference Working Days – OpenWorkdays","category":"everyday","category_name":"Everyday Life","tool_name":"add_global_reference_working_days","featured_mcp_tool":true,"description":"Adds or subtracts working days using the pinned OpenWorkdays national-scope reference for 246 country/territory codes.","use_when":"You need a broad 2026-2028 date offset and accept OpenWorkdays reference semantics, including its source observed/estimated flags.","do_not_use_when":"The task requires a direct official authority, regional/local or employer calendar, or dates outside published coverage.","agent_examples":["Add five broad-reference working days to 2026-10-23 in Australia."],"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":"AE","label":"AE"},{"value":"AF","label":"AF"},{"value":"AG","label":"AG"},{"value":"AI","label":"AI"},{"value":"AL","label":"AL"},{"value":"AM","label":"AM"},{"value":"AO","label":"AO"},{"value":"AR","label":"AR"},{"value":"AS","label":"AS"},{"value":"AT","label":"AT"},{"value":"AU","label":"AU"},{"value":"AW","label":"AW"},{"value":"AX","label":"AX"},{"value":"AZ","label":"AZ"},{"value":"BA","label":"BA"},{"value":"BB","label":"BB"},{"value":"BD","label":"BD"},{"value":"BE","label":"BE"},{"value":"BF","label":"BF"},{"value":"BG","label":"BG"},{"value":"BH","label":"BH"},{"value":"BI","label":"BI"},{"value":"BJ","label":"BJ"},{"value":"BL","label":"BL"},{"value":"BM","label":"BM"},{"value":"BN","label":"BN"},{"value":"BO","label":"BO"},{"value":"BQ","label":"BQ"},{"value":"BR","label":"BR"},{"value":"BS","label":"BS"},{"value":"BT","label":"BT"},{"value":"BW","label":"BW"},{"value":"BY","label":"BY"},{"value":"BZ","label":"BZ"},{"value":"CA","label":"CA"},{"value":"CC","label":"CC"},{"value":"CD","label":"CD"},{"value":"CF","label":"CF"},{"value":"CG","label":"CG"},{"value":"CH","label":"CH"},{"value":"CI","label":"CI"},{"value":"CK","label":"CK"},{"value":"CL","label":"CL"},{"value":"CM","label":"CM"},{"value":"CN","label":"CN"},{"value":"CO","label":"CO"},{"value":"CR","label":"CR"},{"value":"CU","label":"CU"},{"value":"CV","label":"CV"},{"value":"CW","label":"CW"},{"value":"CX","label":"CX"},{"value":"CY","label":"CY"},{"value":"CZ","label":"CZ"},{"value":"DE","label":"DE"},{"value":"DJ","label":"DJ"},{"value":"DK","label":"DK"},{"value":"DM","label":"DM"},{"value":"DO","label":"DO"},{"value":"DZ","label":"DZ"},{"value":"EC","label":"EC"},{"value":"EE","label":"EE"},{"value":"EG","label":"EG"},{"value":"EH","label":"EH"},{"value":"ER","label":"ER"},{"value":"ES","label":"ES"},{"value":"ET","label":"ET"},{"value":"FI","label":"FI"},{"value":"FJ","label":"FJ"},{"value":"FK","label":"FK"},{"value":"FM","label":"FM"},{"value":"FO","label":"FO"},{"value":"FR","label":"FR"},{"value":"GA","label":"GA"},{"value":"GB","label":"GB"},{"value":"GD","label":"GD"},{"value":"GE","label":"GE"},{"value":"GF","label":"GF"},{"value":"GG","label":"GG"},{"value":"GH","label":"GH"},{"value":"GI","label":"GI"},{"value":"GL","label":"GL"},{"value":"GM","label":"GM"},{"value":"GN","label":"GN"},{"value":"GP","label":"GP"},{"value":"GQ","label":"GQ"},{"value":"GR","label":"GR"},{"value":"GS","label":"GS"},{"value":"GT","label":"GT"},{"value":"GU","label":"GU"},{"value":"GW","label":"GW"},{"value":"GY","label":"GY"},{"value":"HK","label":"HK"},{"value":"HN","label":"HN"},{"value":"HR","label":"HR"},{"value":"HT","label":"HT"},{"value":"HU","label":"HU"},{"value":"ID","label":"ID"},{"value":"IE","label":"IE"},{"value":"IL","label":"IL"},{"value":"IM","label":"IM"},{"value":"IN","label":"IN"},{"value":"IQ","label":"IQ"},{"value":"IR","label":"IR"},{"value":"IS","label":"IS"},{"value":"IT","label":"IT"},{"value":"JE","label":"JE"},{"value":"JM","label":"JM"},{"value":"JO","label":"JO"},{"value":"JP","label":"JP"},{"value":"KE","label":"KE"},{"value":"KG","label":"KG"},{"value":"KH","label":"KH"},{"value":"KI","label":"KI"},{"value":"KM","label":"KM"},{"value":"KN","label":"KN"},{"value":"KP","label":"KP"},{"value":"KR","label":"KR"},{"value":"KW","label":"KW"},{"value":"KY","label":"KY"},{"value":"KZ","label":"KZ"},{"value":"LA","label":"LA"},{"value":"LB","label":"LB"},{"value":"LC","label":"LC"},{"value":"LI","label":"LI"},{"value":"LK","label":"LK"},{"value":"LR","label":"LR"},{"value":"LS","label":"LS"},{"value":"LT","label":"LT"},{"value":"LU","label":"LU"},{"value":"LV","label":"LV"},{"value":"LY","label":"LY"},{"value":"MA","label":"MA"},{"value":"MC","label":"MC"},{"value":"MD","label":"MD"},{"value":"ME","label":"ME"},{"value":"MF","label":"MF"},{"value":"MG","label":"MG"},{"value":"MH","label":"MH"},{"value":"MK","label":"MK"},{"value":"ML","label":"ML"},{"value":"MM","label":"MM"},{"value":"MN","label":"MN"},{"value":"MO","label":"MO"},{"value":"MP","label":"MP"},{"value":"MQ","label":"MQ"},{"value":"MR","label":"MR"},{"value":"MS","label":"MS"},{"value":"MT","label":"MT"},{"value":"MU","label":"MU"},{"value":"MV","label":"MV"},{"value":"MW","label":"MW"},{"value":"MX","label":"MX"},{"value":"MY","label":"MY"},{"value":"MZ","label":"MZ"},{"value":"NA","label":"NA"},{"value":"NC","label":"NC"},{"value":"NE","label":"NE"},{"value":"NF","label":"NF"},{"value":"NG","label":"NG"},{"value":"NI","label":"NI"},{"value":"NL","label":"NL"},{"value":"NO","label":"NO"},{"value":"NP","label":"NP"},{"value":"NR","label":"NR"},{"value":"NU","label":"NU"},{"value":"NZ","label":"NZ"},{"value":"OM","label":"OM"},{"value":"PA","label":"PA"},{"value":"PE","label":"PE"},{"value":"PF","label":"PF"},{"value":"PG","label":"PG"},{"value":"PH","label":"PH"},{"value":"PK","label":"PK"},{"value":"PL","label":"PL"},{"value":"PM","label":"PM"},{"value":"PN","label":"PN"},{"value":"PR","label":"PR"},{"value":"PS","label":"PS"},{"value":"PT","label":"PT"},{"value":"PW","label":"PW"},{"value":"PY","label":"PY"},{"value":"QA","label":"QA"},{"value":"RE","label":"RE"},{"value":"RO","label":"RO"},{"value":"RS","label":"RS"},{"value":"RU","label":"RU"},{"value":"RW","label":"RW"},{"value":"SA","label":"SA"},{"value":"SB","label":"SB"},{"value":"SC","label":"SC"},{"value":"SD","label":"SD"},{"value":"SE","label":"SE"},{"value":"SG","label":"SG"},{"value":"SH","label":"SH"},{"value":"SI","label":"SI"},{"value":"SJ","label":"SJ"},{"value":"SK","label":"SK"},{"value":"SL","label":"SL"},{"value":"SM","label":"SM"},{"value":"SN","label":"SN"},{"value":"SO","label":"SO"},{"value":"SR","label":"SR"},{"value":"SS","label":"SS"},{"value":"ST","label":"ST"},{"value":"SV","label":"SV"},{"value":"SX","label":"SX"},{"value":"SY","label":"SY"},{"value":"SZ","label":"SZ"},{"value":"TC","label":"TC"},{"value":"TD","label":"TD"},{"value":"TF","label":"TF"},{"value":"TG","label":"TG"},{"value":"TH","label":"TH"},{"value":"TJ","label":"TJ"},{"value":"TK","label":"TK"},{"value":"TL","label":"TL"},{"value":"TM","label":"TM"},{"value":"TN","label":"TN"},{"value":"TO","label":"TO"},{"value":"TR","label":"TR"},{"value":"TT","label":"TT"},{"value":"TV","label":"TV"},{"value":"TW","label":"TW"},{"value":"TZ","label":"TZ"},{"value":"UA","label":"UA"},{"value":"UG","label":"UG"},{"value":"UM","label":"UM"},{"value":"US","label":"US"},{"value":"UY","label":"UY"},{"value":"UZ","label":"UZ"},{"value":"VA","label":"VA"},{"value":"VC","label":"VC"},{"value":"VE","label":"VE"},{"value":"VG","label":"VG"},{"value":"VI","label":"VI"},{"value":"VN","label":"VN"},{"value":"VU","label":"VU"},{"value":"WF","label":"WF"},{"value":"WS","label":"WS"},{"value":"XK","label":"XK"},{"value":"YE","label":"YE"},{"value":"YT","label":"YT"},{"value":"ZA","label":"ZA"},{"value":"ZM","label":"ZM"},{"value":"ZW","label":"ZW"}],"description":"ISO-style alpha-2 country code supported by the pinned OpenWorkdays reference snapshot.","example":"AU"},{"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":"Regular weekend dates crossed."},{"name":"public_holidays_skipped","label":"Public holidays skipped","type":"list","decimals":4,"description":"Source public-holiday events crossed."},{"name":"territory","label":"Country","type":"string","decimals":4,"description":"Normalized uppercase country code."},{"name":"territory_name","label":"Display name","type":"string","decimals":4,"description":"Calcgrid display name; TW is displayed as 中国台湾省 while the machine code remains TW."},{"name":"source_territory_name","label":"Source country name","type":"string","decimals":4,"description":"Raw country name from the hash-pinned OpenWorkdays source catalogue."},{"name":"weekend_days","label":"Weekend days","type":"string_list","decimals":4,"description":"Weekend convention supplied by the source country file."},{"name":"working_weekend_day","label":"Working weekend day","type":"boolean","decimals":4,"description":"True when the source explicitly marks a weekend date as an official working day."},{"name":"holiday_names","label":"Public holidays","type":"string_list","decimals":4,"description":"Included national-scope public-holiday names on the date."},{"name":"holiday_observed","label":"Observed flag","type":"boolean","decimals":4,"description":"True when an included event is marked observed by the source."},{"name":"holiday_estimated","label":"Estimated flag","type":"boolean","decimals":4,"description":"True when an included event is marked estimated by the source."},{"name":"holiday_policy","label":"Holiday policy","type":"string","decimals":4,"description":"National-scope events with source observed/estimated flags preserved."},{"name":"calendar_scope","label":"Calendar scope","type":"string","decimals":4,"description":"National reference plus country weekend and explicit working-weekend dates."},{"name":"calendar_profile","label":"Calendar profile","type":"string","decimals":4,"description":"global-working-day-reference."},{"name":"substitute_day_policy","label":"Substitute-day policy","type":"string","decimals":4,"description":"Source flags are preserved; no new substitute-day rule is inferred."},{"name":"source_quality","label":"Source quality","type":"string","decimals":4,"description":"Open derived reference, not a direct national authority feed."},{"name":"dataset_version","label":"Dataset version","type":"string","decimals":4,"description":"Pinned OpenWorkdays 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_url","label":"Source index","type":"string","decimals":4,"description":"Pinned OpenWorkdays source index."}],"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 OpenWorkdays reference snapshot.","type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AO","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HN","HR","HT","HU","ID","IE","IL","IM","IN","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","XK","YE","YT","ZA","ZM","ZW"],"examples":["AU"],"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":"AU","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":"Regular weekend dates crossed. Unit: days.","type":"integer","x-unit":"days"},"public_holidays_skipped":{"description":"Source public-holiday events crossed.","type":"array"},"territory":{"description":"Normalized uppercase country code.","type":"string"},"territory_name":{"description":"Calcgrid display name; TW is displayed as 中国台湾省 while the machine code remains TW.","type":"string"},"source_territory_name":{"description":"Raw country name from the hash-pinned OpenWorkdays source catalogue.","type":"string"},"weekend_days":{"description":"Weekend convention supplied by the source country file.","type":"array","items":{"type":"string"}},"working_weekend_day":{"description":"True when the source explicitly marks a weekend date as an official working day.","type":"boolean"},"holiday_names":{"description":"Included national-scope public-holiday names on the date.","type":"array","items":{"type":"string"}},"holiday_observed":{"description":"True when an included event is marked observed by the source.","type":"boolean"},"holiday_estimated":{"description":"True when an included event is marked estimated by the source.","type":"boolean"},"holiday_policy":{"description":"National-scope events with source observed/estimated flags preserved.","type":"string"},"calendar_scope":{"description":"National reference plus country weekend and explicit working-weekend dates.","type":"string"},"calendar_profile":{"description":"global-working-day-reference.","type":"string"},"substitute_day_policy":{"description":"Source flags are preserved; no new substitute-day rule is inferred.","type":"string"},"source_quality":{"description":"Open derived reference, not a direct national authority feed.","type":"string"},"dataset_version":{"description":"Pinned OpenWorkdays 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_url":{"description":"Pinned OpenWorkdays source index.","type":"string"}}},"formula":"move one Gregorian day at a time; decrement remaining only when the source reference status is_working_day=true","method":"The start date is excluded for non-zero offsets. Skip source weekends and public-holiday events; preserve source flags in the result.","sources":[{"name":"OpenWorkdays generated public-holiday and working-day data","url":"https://openworkdays.com/api/v1/countries.json","type":"open_derived_reference","retrieved_at":"2026-09-28","licence":"CC BY 4.0","licence_url":"https://creativecommons.org/licenses/by/4.0/","note":"National-scope reference generated from a rules-based open library; regional differences, employer calendars and late government proclamations may be absent. Observed and estimated flags are preserved from the source; no new substitute-day inference is made."}],"freshness":{"type":"static","max_age_seconds":null,"note":"Pinned OpenWorkdays 2026-2028 snapshot."},"examples":[{"name":"Australia offset","inputs":{"start_date":"2026-10-23","territory":"AU","working_days":5},"expected":{"result_date":"2026-10-30"},"url":"https://tttkmbb.com/api/v1/calculate/global-reference-add-working-days?start_date=2026-10-23&territory=AU&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 regional closures included?","a":"This is a broad national-scope reference generated from an open rules-based library. It may omit regional, employer, bank, exchange, school or one-off authority closures, and future lunar/late-proclaimed dates can be marked estimated. Verify material legal, payroll, banking or settlement decisions against the responsible authority."}],"tags":["add global working days","public holiday reference","OpenWorkdays deadline"],"related":[{"calculator_id":"global-reference-working-day","reason":"Inspect the source-labelled status of one date."},{"calculator_id":"global-reference-working-days-between","reason":"Count reference working days in a range."}],"links":{"html":"https://tttkmbb.com/everyday/global-reference-add-working-days","markdown":"https://tttkmbb.com/everyday/global-reference-add-working-days.md","json":"https://tttkmbb.com/everyday/global-reference-add-working-days.json","api":"https://tttkmbb.com/api/v1/calculate/global-reference-add-working-days","schema":"https://tttkmbb.com/api/v1/calculators/global-reference-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:03:22Z","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-reference-add-working-days","markdown":"https://tttkmbb.com/everyday/global-reference-add-working-days.md","api":"https://tttkmbb.com/api/v1/calculate/global-reference-add-working-days"}}