{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"uk-add-working-days"},"result":{"entity_type":"calculator","id":"uk-add-working-days","calculator_id":"uk-add-working-days","canonical_url":"https://tttkmbb.com/everyday/uk-add-working-days","name":"Add UK Working Days","title":"Add UK Working Days – Deadlines with Official GOV.UK Bank Holidays","category":"everyday","category_name":"Everyday Life","tool_name":"add_uk_working_days","featured_mcp_tool":true,"description":"Adds or subtracts working days for England and Wales, Scotland or Northern Ireland, skipping weekends and the selected division's official bank holidays.","use_when":"You need a deadline a stated number of UK working days before or after a 2024-2028 date and the correct division's bank holidays matter.","do_not_use_when":"You need calendar days, a local/employer/market calendar, a non-UK jurisdiction or a result outside 2024-2028.","agent_examples":["What date is five England and Wales working days after 23 December 2026?","Add two Scottish working days to 12 June 2026, accounting for the official bank holiday.","Subtract ten Northern Ireland business days from 20 July 2027."],"inputs":[{"name":"start_date","label":"Start date","type":"date","required":true,"description":"Starting UK civil date in YYYY-MM-DD format, within 2024-2028.","example":"2026-12-23"},{"name":"working_days","label":"Working days","type":"integer","unit":"working days","required":true,"min":-1200,"max":1200,"description":"Signed working-day offset. The start date is excluded when non-zero; negative values move backward.","example":5},{"name":"division","label":"UK division","type":"enum","required":false,"default":"england-and-wales","values":[{"value":"england-and-wales","label":"England and Wales","aliases":["england","wales","england and wales","e&w"]},{"value":"scotland","label":"Scotland","aliases":["scottish"]},{"value":"northern-ireland","label":"Northern Ireland","aliases":["ni","n. ireland"]}],"description":"GOV.UK bank-holiday division. England and Wales share one official list; Scotland and Northern Ireland have separate lists.","example":"england-and-wales"}],"outputs":[{"name":"division","label":"Division","type":"string","decimals":4,"description":"Canonical GOV.UK division id."},{"name":"division_name","label":"Division name","type":"string","decimals":4,"description":"Human-readable UK division."},{"name":"start_date","label":"Start date","type":"date","decimals":4,"description":"Input start date."},{"name":"result_date","label":"Result date","type":"date","decimals":4,"description":"Date reached after adding the working-day offset."},{"name":"result_weekday","label":"Result weekday","type":"string","decimals":4,"description":"Weekday of result_date."},{"name":"result_is_working_day","label":"Result is working day","type":"boolean","decimals":4,"description":"Whether result_date is a working day."},{"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 result_date minus start_date."},{"name":"non_working_days_skipped","label":"Non-working days skipped","type":"integer","unit":"days","decimals":4,"description":"Weekend and bank-holiday dates crossed but not counted."},{"name":"bank_holidays_skipped","label":"Bank holidays skipped","type":"list","decimals":4,"description":"Official bank-holiday dates crossed, with titles and notes."},{"name":"dataset_version","label":"Dataset version","type":"string","decimals":4,"description":"Pinned Calcgrid snapshot version of the GOV.UK bank-holiday package."},{"name":"coverage_start","label":"Coverage start","type":"date","decimals":4,"description":"First supported date in this pinned package."},{"name":"coverage_end","label":"Coverage end","type":"date","decimals":4,"description":"Last supported date in this pinned package."},{"name":"source_snapshot_sha256","label":"Source snapshot SHA-256","type":"string","decimals":4,"description":"SHA-256 of the complete official GOV.UK JSON response used for this package."}],"input_schema":{"type":"object","properties":{"start_date":{"description":"Starting UK civil date in YYYY-MM-DD format, within 2024-2028.","type":"string","format":"date","examples":["2026-12-23"]},"working_days":{"description":"Signed working-day offset. The start date is excluded when non-zero; negative values move backward. Unit: working days.","type":"integer","minimum":-1200,"maximum":1200,"examples":[5],"x-unit":"working days"},"division":{"description":"GOV.UK bank-holiday division. England and Wales share one official list; Scotland and Northern Ireland have separate lists.","type":"string","enum":["england-and-wales","scotland","northern-ireland"],"default":"england-and-wales","examples":["england-and-wales"]}},"additionalProperties":false,"required":["start_date","working_days"],"examples":[{"start_date":"2026-12-23","working_days":5,"division":"england-and-wales"},{"start_date":"2026-06-12","working_days":2,"division":"scotland"}]},"output_schema":{"type":"object","properties":{"division":{"description":"Canonical GOV.UK division id.","type":"string"},"division_name":{"description":"Human-readable UK division.","type":"string"},"start_date":{"description":"Input start date.","type":"string","format":"date"},"result_date":{"description":"Date reached after adding the working-day offset.","type":"string","format":"date"},"result_weekday":{"description":"Weekday of result_date.","type":"string"},"result_is_working_day":{"description":"Whether result_date is a working day.","type":"boolean"},"working_days_added":{"description":"Signed requested offset. Unit: working days.","type":"integer","x-unit":"working days"},"calendar_days_elapsed":{"description":"Signed Gregorian difference result_date minus start_date. Unit: days.","type":"integer","x-unit":"days"},"non_working_days_skipped":{"description":"Weekend and bank-holiday dates crossed but not counted. Unit: days.","type":"integer","x-unit":"days"},"bank_holidays_skipped":{"description":"Official bank-holiday dates crossed, with titles and notes.","type":"array"},"dataset_version":{"description":"Pinned Calcgrid snapshot version of the GOV.UK bank-holiday package.","type":"string"},"coverage_start":{"description":"First supported date in this pinned package.","type":"string","format":"date"},"coverage_end":{"description":"Last supported date in this pinned package.","type":"string","format":"date"},"source_snapshot_sha256":{"description":"SHA-256 of the complete official GOV.UK JSON response used for this package.","type":"string"}}},"formula":"move one calendar day at a time in sign(working_days); decrement only when the selected UK division reports is_working_day=true","method":"The start date is excluded for non-zero offsets. Official bank holidays and ordinary weekends are skipped. A zero offset returns the start date unchanged.","sources":[{"name":"GOV.UK Bank Holidays API","url":"https://www.gov.uk/bank-holidays.json","type":"government","retrieved_at":"2026-09-26","note":"Official JSON for England and Wales, Scotland and Northern Ireland; snapshot retrieved 2026-09-26 with SHA-256 538b3482c28b85ecd2db606a0d5ae6ad17248900b6498700ce0a48d26a3ecde6."},{"name":"Open Government Licence v3.0","url":"https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/","type":"licence","retrieved_at":"2026-09-26","note":"GOV.UK content is reusable under the Open Government Licence subject to attribution and its stated conditions."}],"freshness":{"type":"static","max_age_seconds":null,"note":"Pinned GOV.UK snapshot for 2024-2028; calculations fail instead of extrapolating outside coverage."},"examples":[{"name":"Christmas and New Year deadline in England and Wales","inputs":{"start_date":"2026-12-23","working_days":5,"division":"england-and-wales"},"expected":{"result_date":"2027-01-04","result_weekday":"Monday","result_is_working_day":true,"working_days_added":5,"calendar_days_elapsed":12,"non_working_days_skipped":7},"url":"https://tttkmbb.com/api/v1/calculate/uk-add-working-days?start_date=2026-12-23&working_days=5&division=england-and-wales"},{"name":"Scottish World Cup bank holiday is skipped","inputs":{"start_date":"2026-06-12","working_days":2,"division":"scotland"},"expected":{"result_date":"2026-06-17","working_days_added":2,"calendar_days_elapsed":5,"non_working_days_skipped":3},"url":"https://tttkmbb.com/api/v1/calculate/uk-add-working-days?start_date=2026-06-12&working_days=2&division=scotland"}],"faq":[{"q":"Does the start date count?","a":"No for non-zero offsets. Plus one means the first working day after start_date; minus one means the first before it."},{"q":"Why can England and Scotland return different dates?","a":"Their official bank-holiday lists differ, including summer holidays and some one-off events."}],"tags":["add UK business days","UK deadline","England working days","Scotland working days","Northern Ireland SLA","bank holiday calculator"],"related":[{"calculator_id":"uk-working-day","reason":"Inspect one date and its official source."},{"calculator_id":"uk-working-days-between","reason":"Count working days in a UK range."},{"calculator_id":"china-add-working-days","reason":"Use the mainland China official calendar with 调休."}],"links":{"html":"https://tttkmbb.com/everyday/uk-add-working-days","markdown":"https://tttkmbb.com/everyday/uk-add-working-days.md","json":"https://tttkmbb.com/everyday/uk-add-working-days.json","api":"https://tttkmbb.com/api/v1/calculate/uk-add-working-days","schema":"https://tttkmbb.com/api/v1/calculators/uk-add-working-days","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-26"},"timestamp":"2026-09-27T00:04:57Z","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","html":"https://tttkmbb.com/everyday/uk-add-working-days","markdown":"https://tttkmbb.com/everyday/uk-add-working-days.md","api":"https://tttkmbb.com/api/v1/calculate/uk-add-working-days"}}