{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"uk-working-days-between"},"result":{"entity_type":"calculator","id":"uk-working-days-between","calculator_id":"uk-working-days-between","canonical_url":"https://tttkmbb.com/everyday/uk-working-days-between","name":"UK Working Days Between Dates","title":"UK Working Days Between Dates – Count Official Bank Holidays by Division","category":"everyday","category_name":"Everyday Life","tool_name":"count_uk_working_days","featured_mcp_tool":true,"description":"Counts working and non-working dates in England and Wales, Scotland or Northern Ireland using the official GOV.UK bank-holiday list instead of a weekday-only approximation.","use_when":"You need a 2024-2028 UK SLA, payroll, project or delivery-day count and the selected division's bank holidays must be excluded.","do_not_use_when":"You need only elapsed calendar days, a local/employer/market calendar, another jurisdiction or dates outside 2024-2028.","agent_examples":["How many England and Wales working days are there from 24 December 2026 through 4 January 2027?","Count Northern Ireland business days from 10 to 14 July 2026 inclusive.","How many Scottish working days fall between 1 and 20 June 2026?"],"inputs":[{"name":"start_date","label":"Start date","type":"date","required":true,"description":"First range endpoint in YYYY-MM-DD format, within 2024-2028.","example":"2026-12-24"},{"name":"end_date","label":"End date","type":"date","required":true,"description":"Second range endpoint in YYYY-MM-DD format, within 2024-2028.","example":"2027-01-04"},{"name":"include_start_date","label":"Include start date","type":"boolean","required":false,"default":true,"description":"Whether the normalized earlier endpoint participates in the count.","example":true},{"name":"include_end_date","label":"Include end date","type":"boolean","required":false,"default":true,"description":"Whether the normalized later endpoint participates in the count.","example":true},{"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":"normalized_start_date","label":"Normalized start","type":"date","decimals":4,"description":"Earlier endpoint after normalization."},{"name":"normalized_end_date","label":"Normalized end","type":"date","decimals":4,"description":"Later endpoint after normalization."},{"name":"working_days","label":"Working days","type":"integer","unit":"working days","decimals":4,"description":"Monday-Friday dates not listed as a bank holiday."},{"name":"non_working_days","label":"Non-working days","type":"integer","unit":"days","decimals":4,"description":"Weekend and bank-holiday dates in the selected range."},{"name":"calendar_days_counted","label":"Calendar days counted","type":"integer","unit":"days","decimals":4,"description":"Total dates included after endpoint rules."},{"name":"bank_holidays_counted","label":"Bank holidays counted","type":"list","decimals":4,"description":"Official bank-holiday events in the selected range."},{"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":"First range endpoint in YYYY-MM-DD format, within 2024-2028.","type":"string","format":"date","examples":["2026-12-24"]},"end_date":{"description":"Second range endpoint in YYYY-MM-DD format, within 2024-2028.","type":"string","format":"date","examples":["2027-01-04"]},"include_start_date":{"description":"Whether the normalized earlier endpoint participates in the count.","type":"boolean","default":true,"examples":[true]},"include_end_date":{"description":"Whether the normalized later endpoint participates in the count.","type":"boolean","default":true,"examples":[true]},"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","end_date"],"examples":[{"start_date":"2026-12-24","end_date":"2027-01-04","include_start_date":true,"include_end_date":true,"division":"england-and-wales"},{"start_date":"2026-07-10","end_date":"2026-07-14","include_start_date":true,"include_end_date":true,"division":"northern-ireland"}]},"output_schema":{"type":"object","properties":{"division":{"description":"Canonical GOV.UK division id.","type":"string"},"division_name":{"description":"Human-readable UK division.","type":"string"},"normalized_start_date":{"description":"Earlier endpoint after normalization.","type":"string","format":"date"},"normalized_end_date":{"description":"Later endpoint after normalization.","type":"string","format":"date"},"working_days":{"description":"Monday-Friday dates not listed as a bank holiday. Unit: working days.","type":"integer","x-unit":"working days"},"non_working_days":{"description":"Weekend and bank-holiday dates in the selected range. Unit: days.","type":"integer","x-unit":"days"},"calendar_days_counted":{"description":"Total dates included after endpoint rules. Unit: days.","type":"integer","x-unit":"days"},"bank_holidays_counted":{"description":"Official bank-holiday events in the selected range.","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":"for each included date: working_days += is_working_day(date); non_working_days += not is_working_day(date)","method":"Endpoints are included by default. If the second date is earlier, endpoints are swapped before inclusion rules are applied. Bank-holiday events override the ordinary weekday rule.","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; no extrapolation beyond coverage."},"examples":[{"name":"England and Wales Christmas-to-New-Year range","inputs":{"start_date":"2026-12-24","end_date":"2027-01-04","include_start_date":true,"include_end_date":true,"division":"england-and-wales"},"expected":{"working_days":5,"non_working_days":7,"calendar_days_counted":12},"url":"https://tttkmbb.com/api/v1/calculate/uk-working-days-between?start_date=2026-12-24&end_date=2027-01-04&include_start_date=true&include_end_date=true&division=england-and-wales"},{"name":"Northern Ireland Battle of the Boyne substitute","inputs":{"start_date":"2026-07-10","end_date":"2026-07-14","include_start_date":true,"include_end_date":true,"division":"northern-ireland"},"expected":{"working_days":2,"non_working_days":3,"calendar_days_counted":5,"bank_holidays_counted":[{"date":"2026-07-13","title":"Battle of the Boyne (Orangemen’s Day)","notes":"Substitute day"}]},"url":"https://tttkmbb.com/api/v1/calculate/uk-working-days-between?start_date=2026-07-10&end_date=2026-07-14&include_start_date=true&include_end_date=true&division=northern-ireland"}],"faq":[{"q":"Are both endpoints included?","a":"Yes by default. Set either inclusion input to false if a contract excludes that endpoint."},{"q":"Does a substitute day count as a bank holiday?","a":"Yes. The official feed supplies the observed date and labels it as a substitute day."}],"tags":["count UK business days","UK SLA days","England Wales bank holidays","Scotland business days","Northern Ireland working days"],"related":[{"calculator_id":"uk-working-day","reason":"Inspect one date and its official source."},{"calculator_id":"uk-add-working-days","reason":"Find a deadline after a working-day offset."},{"calculator_id":"china-working-days-between","reason":"Use the mainland China official calendar including 调休."}],"links":{"html":"https://tttkmbb.com/everyday/uk-working-days-between","markdown":"https://tttkmbb.com/everyday/uk-working-days-between.md","json":"https://tttkmbb.com/everyday/uk-working-days-between.json","api":"https://tttkmbb.com/api/v1/calculate/uk-working-days-between","schema":"https://tttkmbb.com/api/v1/calculators/uk-working-days-between","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-26"},"timestamp":"2026-09-27T00:03:59Z","next_actions":[{"tool":"count_uk_working_days","calculator_id":"uk-working-days-between","reason":"Run UK Working Days Between Dates with the inputs above."}],"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","markdown":"https://tttkmbb.com/everyday/uk-working-days-between.md"}}