{"uid":"cap_dlrKm8RQh5TpuVUvd91wx","slug":"uk-working-days-calculator-1fc61438","name":"UK Working Days Calculator","description":"UK working-day calculator using GOV.UK bank holidays for England and Wales, Scotland or Northern Ireland. Next working day, add or subtract working days (e.g. payment settlement, notice periods, delivery dates), count working days between dates, and list bank holidays. Dates must fall within GOV.UK coverage; out-of-range dates are refused, not guessed.","url":"https://uk-working-days.agent-fee-check.workers.dev/holidays?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["from","to"],"properties":{"to":{"type":"string","description":"Last day (inclusive) as YYYY-MM-DD"},"from":{"type":"string","description":"First day as YYYY-MM-DD"},"region":{"enum":["england-and-wales","scotland","northern-ireland"],"type":"string","description":"Defaults to england-and-wales"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"to":"2026-12-31","from":"2026-01-01","region":"england-and-wales","summary":"8 bank holidays in England and Wales from 2026-01-01 to 2026-12-31.","bank_holidays":[{"day":"Thursday","date":"2026-01-01","title":"New Year’s Day"},{"day":"Friday","date":"2026-04-03","title":"Good Friday"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_86t0IZdh0xjKsLDr5re_q","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates working days between two dates, adds or subtracts working days from a date, and lists UK bank holidays for England & Wales, Scotland, or Northern Ireland using official GOV.UK data.","exampleAgentPrompt":"How many working days are there between 1st March 2025 and 31st March 2025 in England and Wales? I need to check if a 20-working-day notice period fits in that window.","exampleUseCases":[{"title":"Payment settlement date calculation","prompt":"I need to know what date a BACS payment will settle if it's initiated on 28th April 2025 — add 3 working days for England and Wales, avoiding bank holidays."},{"title":"Legal notice period deadline","prompt":"My employee handed in their notice on 14th July 2025 and their contract says 4 weeks' notice in working days. What's their last working day in Scotland?"},{"title":"Count working days for project deadline","prompt":"How many working days are there between 1st June 2025 and 30th June 2025 in Northern Ireland? I need to plan a project sprint."}],"resultDescription":"Returns a plain-text summary string describing the result of the working-day calculation — such as the count of working days, the computed target date after adding/subtracting days, or a list of bank holidays in the specified region and date range. The response does not include raw date arrays, only a human-readable summary.","failureModes":["Date out of GOV.UK coverage range — returns an error, does not guess or extrapolate","Invalid date format (not YYYY-MM-DD) — request refused","'from' date is after 'to' date — likely returns an error or zero result","Unrecognised region value — defaults to england-and-wales or returns error","Network/upstream GOV.UK data unavailable — service may return an error"],"whenToPreferThis":"Use this endpoint when you need accurate UK-specific working-day calculations that respect official bank holidays for a specific UK region (England & Wales, Scotland, or Northern Ireland). Prefer it over generic business-day calculators that lack UK bank holiday data, or when you need region-specific correctness (e.g. Scottish bank holidays differ from English ones). Ideal for payment settlement, legal notice periods, HR processes, and logistics scheduling within the UK.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T00:36:52.044Z","isFirstParty":false,"canonicalSlug":"uk-working-days-calculator-1fc61438"}