{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"uk-working-day"},"result":{"entity_type":"calculator","id":"uk-working-day","calculator_id":"uk-working-day","canonical_url":"https://tttkmbb.com/everyday/uk-working-day","name":"UK Working Day Checker","title":"UK Working Day Checker – Official GOV.UK Bank Holidays by Division","category":"everyday","category_name":"Everyday Life","tool_name":"check_uk_working_day","featured_mcp_tool":true,"description":"Checks whether a date is a normal working day in England and Wales, Scotland or Northern Ireland using a pinned snapshot of the official GOV.UK bank-holiday feed.","use_when":"You need to know whether a 2024-2028 UK date is a Monday-Friday working day after applying the official bank holidays for the selected division.","do_not_use_when":"You need a local council, school, employer, financial-market, emergency-closure or non-UK calendar, or a date outside 2024-2028.","agent_examples":["Is 28 December 2026 a working day in England and Wales, or the Boxing Day substitute holiday?","Is Scotland working on 15 June 2026?","Check whether 13 July 2026 is a working day in Northern Ireland."],"inputs":[{"name":"date","label":"Date","type":"date","required":true,"description":"UK civil date in YYYY-MM-DD format, within 2024-2028.","example":"2026-12-28"},{"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":"date","label":"Date","type":"date","decimals":4,"description":"Checked civil date."},{"name":"weekday","label":"Weekday","type":"string","decimals":4,"description":"Gregorian weekday."},{"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":"is_working_day","label":"Working day","type":"boolean","decimals":4,"description":"True only for Monday-Friday dates not listed as a bank holiday."},{"name":"day_type","label":"Day type","type":"string","decimals":4,"description":"bank_holiday, regular_weekend or regular_weekday."},{"name":"bank_holiday_name","label":"Bank holiday","type":"string","decimals":4,"description":"Official event title when the date is a bank holiday; otherwise empty."},{"name":"bank_holiday_notes","label":"Official notes","type":"string","decimals":4,"description":"GOV.UK notes such as Substitute day; otherwise empty."},{"name":"status_basis","label":"Status basis","type":"string","decimals":4,"description":"Evidence-based explanation for the classification."},{"name":"source_url","label":"Source URL","type":"string","decimals":4,"description":"Official GOV.UK JSON source."},{"name":"licence","label":"Licence","type":"string","decimals":4,"description":"Reuse licence for GOV.UK content."},{"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":{"date":{"description":"UK civil date in YYYY-MM-DD format, within 2024-2028.","type":"string","format":"date","examples":["2026-12-28"]},"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":["date"],"examples":[{"date":"2026-12-28","division":"england-and-wales"},{"date":"2026-06-15","division":"scotland"}]},"output_schema":{"type":"object","properties":{"date":{"description":"Checked civil date.","type":"string","format":"date"},"weekday":{"description":"Gregorian weekday.","type":"string"},"division":{"description":"Canonical GOV.UK division id.","type":"string"},"division_name":{"description":"Human-readable UK division.","type":"string"},"is_working_day":{"description":"True only for Monday-Friday dates not listed as a bank holiday.","type":"boolean"},"day_type":{"description":"bank_holiday, regular_weekend or regular_weekday.","type":"string"},"bank_holiday_name":{"description":"Official event title when the date is a bank holiday; otherwise empty.","type":"string"},"bank_holiday_notes":{"description":"GOV.UK notes such as Substitute day; otherwise empty.","type":"string"},"status_basis":{"description":"Evidence-based explanation for the classification.","type":"string"},"source_url":{"description":"Official GOV.UK JSON source.","type":"string"},"licence":{"description":"Reuse licence for GOV.UK content.","type":"string"},"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":"official bank-holiday event → non-working; else Saturday/Sunday → non-working; else Monday-Friday → working","method":"The selected division's official GOV.UK bank-holiday events are applied before the ordinary Monday-Friday rule. Substitute-day notes are preserved, and every result returns the pinned dataset version and source hash.","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 official GOV.UK snapshot retrieved 2026-09-26; coverage 2024-2028. The upstream feed is checked before a new snapshot is published."},"examples":[{"name":"England and Wales Boxing Day substitute","inputs":{"date":"2026-12-28","division":"england-and-wales"},"expected":{"weekday":"Monday","is_working_day":false,"day_type":"bank_holiday","bank_holiday_name":"Boxing Day","bank_holiday_notes":"Substitute day"},"url":"https://tttkmbb.com/api/v1/calculate/uk-working-day?date=2026-12-28&division=england-and-wales"},{"name":"Scotland World Cup bank holiday","inputs":{"date":"2026-06-15","division":"scotland"},"expected":{"weekday":"Monday","is_working_day":false,"day_type":"bank_holiday","bank_holiday_name":"World Cup bank holiday"},"url":"https://tttkmbb.com/api/v1/calculate/uk-working-day?date=2026-06-15&division=scotland"}],"faq":[{"q":"Why are there three UK divisions?","a":"GOV.UK publishes separate bank-holiday lists for England and Wales, Scotland and Northern Ireland. Choosing the wrong division can change the answer."},{"q":"Does this include local or employer holidays?","a":"No. It applies the official national/division bank-holiday feed and the ordinary weekend rule only."}],"tags":["UK working day","UK bank holiday","England Wales business day","Scotland bank holiday","Northern Ireland working day","GOV.UK holidays"],"related":[{"calculator_id":"uk-add-working-days","reason":"Add or subtract UK working days."},{"calculator_id":"uk-working-days-between","reason":"Count UK working days in a range."},{"calculator_id":"china-working-day","reason":"Check the mainland China official calendar including 调休."}],"links":{"html":"https://tttkmbb.com/everyday/uk-working-day","markdown":"https://tttkmbb.com/everyday/uk-working-day.md","json":"https://tttkmbb.com/everyday/uk-working-day.json","api":"https://tttkmbb.com/api/v1/calculate/uk-working-day","schema":"https://tttkmbb.com/api/v1/calculators/uk-working-day","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-26"},"timestamp":"2026-09-27T00:10:23Z","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-working-day","markdown":"https://tttkmbb.com/everyday/uk-working-day.md","api":"https://tttkmbb.com/api/v1/calculate/uk-working-day"}}