UK Working Days and Court Deadlines Calculator

Date arithmetic is where people and AI assistants slip: "10 working days from 18 December" has to skip Christmas, the substitute Boxing Day and New Year's Day, and the answer differs in Scotland. This Actor uses the official GOV.UK bank holiday data for England and Wales, Scotland and Northern Ireland 1, and works out court time limits under CPR 2.8 3.

What it does and who it is for

For finance teams, solicitors, landlords and AI agents. Send a list of date questions; get one answer row per question.

Modes

mode	Needs	Returns
add-working-days	date, days (negative goes back)	The date days working days away; the start date doesn't count
working-days-between	date, to	Working days after date, up to and including to
is-working-day	date	isWorkingDay, and the reason if not
next-working-day, previous-working-day	date, optional orSame: true	The nearest working day
bank-holidays	date, to	Bank holidays in that range
cpr-days-before	date (the event), days	Last day to act "at least days days before"
cpr-days-after	date, days	Earliest day for an event "at least days days after"
cpr-within-days	date, days, optional courtOffice: true	Last day to act "within days days"

CPR 2.8 3: periods expressed in days are clear days, so the day the period starts, and the day of the event that ends it, don't count. For periods of 5 days or less, Saturdays, Sundays and bank holidays (including Christmas Day and Good Friday) don't count either. With courtOffice, a last day that falls when the court office is closed moves to the next day it's open (CPR 2.8(5)).

Quick start

Prefill input:

{
  "items": [
    {
      "label": "Invoice due in 10 working days",
      "mode": "add-working-days",
      "date": "2026-12-18",
      "days": 10
    },
    {
      "label": "Is Boxing Day substitute a working day?",
      "mode": "is-working-day",
      "date": "2026-12-28"
    },
    {
      "label": "Working days in April 2026",
      "mode": "working-days-between",
      "date": "2026-03-31",
      "to": "2026-04-30"
    },
    {
      "label": "Scotland: next working day after Hogmanay",
      "mode": "next-working-day",
      "date": "2026-12-31",
      "nation": "scotland"
    },
    {
      "label": "Serve application notice (3 clear days)",
      "mode": "cpr-days-before",
      "date": "2026-04-08",
      "days": 3
    },
    {
      "label": "Defence due (14 days, court office)",
      "mode": "cpr-within-days",
      "date": "2026-12-12",
      "days": 14,
      "courtOffice": true
    }
  ]
}

Six rows result, one per item. The first:

{
  "index": 0,
  "label": "Invoice due in 10 working days",
  "mode": "add-working-days",
  "nation": "england-and-wales",
  "date": "2026-12-18",
  "days": 10,
  "result": "2027-01-06",
  "resultWeekday": "Wednesday",
  "error": null
}

Key values in the other five rows:

index	Key values
1	isWorkingDay: false, reason: "bank holiday: Boxing Day"
2	workingDays: 20
3	result: "2027-01-05" (Scotland)
4	result: "2026-03-31", with a rule sentence
5	result: "2026-12-29", courtOffice: true, with a rule sentence

Run on the bundled GOV.UK snapshot of 3 October 2026. OUTPUT adds dataSource and sources.

Input fields

Field	Type	Required	Default	Meaning
items	array of objects	yes	none	1 to 5,000 calculations: mode, date, the fields in the Modes table, optional nation and label
nation	string	no	england-and-wales	Or scotland, northern-ireland; items can override. CPR modes always use England and Wales
weekend	array of integers	no	[0, 6]	Non-working weekday numbers, 0 Sunday to 6 Saturday. Not for CPR modes
closures	array of strings	no	none	Extra non-working dates, e.g. a Christmas shutdown, YYYY-MM-DD. Not for CPR modes
useLiveData	boolean	no	true	Read GOV.UK's live list at run time; the bundled copy is used if GOV.UK is unreachable

Output fields

Field	Meaning
index, label, mode, nation, date	The item answered, with nation and date used
days, to	days and end date as given
result, resultWeekday	Answer date and its weekday (add, next, previous and CPR modes)
workingDays, counting	working-days-between: the count (negative if to is earlier) and how it is counted
isWorkingDay, reason, weekday	is-working-day: the answer, why not, and the weekday
holidays	bank-holidays: holidays in the range, with date, title and weekday
rule, courtOffice	CPR 2.8 rule applied, and whether CPR 2.8(5) was applied
error	null on success, otherwise why the item failed

Use from code

curl -X POST "https://api.apify.com/v2/acts/landlordtools~uk-working-days/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"items": [{"mode": "add-working-days", "date": "2026-12-18", "days": 10}]}'

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });
const run = await client.actor('landlordtools/uk-working-days').call({
  items: [{ mode: 'add-working-days', date: '2026-12-18', days: 10 }],
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0].result);

Use with AI agents

AI agents can call this Actor through Apify's MCP server (https://mcp.apify.com) instead of counting days themselves. Example prompt: "What is 10 working days after 18 December 2026 in England?"

Limits

The live GOV.UK list 1 is read at run time, with the bundled copy as fallback. GOV.UK publishes bank holidays from 2019 to 2028. A calculation that reaches outside the published years returns an error, never a guess. Local holidays and court-specific closures aren't included: add them with closures, or check with the court. General information, not legal advice.

Integrations

Power Platform, OpenAPI, Excel and Google Sheets files are in integrations/README.md. Apify's Zapier, Make and n8n apps work too.

Pricing

Pay per event: $2 per 1,000 results, plus Apify's tiny per-run start fee ($0.00005). See the Pricing tab for the current price.

Related Actors

• UK Business Deadlines: company and tax deadlines from a date.
• UK Late Payment Interest: interest on a late business invoice.
• UK Renters' Rights Dates: rent increase and pet request dates.
• England PRS Registration Deadline: PRS registration dates.

Sources

1. GOV.UK: UK bank holidays (data feed for England and Wales, Scotland and Northern Ireland). Accessed 3 October 2026.
2. GOV.UK: UK bank holidays. Accessed 3 October 2026.
3. Civil Procedure Rules, Part 2, rule 2.8: time. Accessed 3 October 2026.