UK Bank Holidays and Business Day Calculator

How to use it: 3 steps

1. Make a free Apify accountApify is the cloud platform where our tools run. The free plan gives you $5 of usage every month, no credit card needed. You pay Apify, not us.
2. Paste your input and press StartNo code needed: you fill in a form (the input). It already has a working example. For example: england-and-wales in UK divisions. Each start is one run.
3. Download the resultsWhen the run ends, the results are in a table (the dataset). Open Output, press Export and pick Excel or CSV. JSON and the API are there too.

This tool is an Apify Actor: a small program that runs on Apify. You can also run it on a schedule, for example every Monday. New to it? Read how it works, step by step and the 8 words you need first.

What it does

UK Bank Holidays & Business Day Calculator lists UK bank holidays from GOV.UK for England and Wales, Scotland and Northern Ireland. It also adds or counts business days for your dates, with substitute days, custom weekends and your own closure dates. You get one clean row per holiday or per calculation.

• list: one row per bank holiday, division and year. Substitute days (for example Boxing Day moved to Monday 28 December 2026) are marked with isSubstituteDay.
• calculate: up to 100 calculations per run. Each calculation either adds a number of business days to a start date (addBusinessDays, negative goes back in time) or counts business days between two dates (endDate). You get one row per calculation and division, with the result date and the holidays it skipped.

Who uses it

Price

Pay per event: you pay for each result the tool saves, plus a small start fee for each run. The price includes Apify platform costs. Apify bills you, not us. Prices below are for the Apify free plan.

Examples

• One calculation: about $0.0028.
• 1,000 calculations: about $1.81 (10 runs of up to 100).
• Every day 100 calculations, for 30 days: about $5.43 a month.
• 100 calculations once a week (4 runs a month): about $0.72 a month.

Free to try: the Apify free plan gives you $5 of usage every month, no credit card needed. That is enough for about 2,700 calculations.

Prices checked on 24 October 2026. See the current price on Apify.

Questions

Details

For developers

Sample result

One result from a real test run, in JSON. Real values change from run to run. In Excel or CSV each field is a column.

{
  "recordType": "calculation",
  "status": "complete",
  "calculationId": "invoice-due",
  "division": "england-and-wales",
  "operation": "add_business_days",
  "startDate": "2026-12-24",
  "addBusinessDays": 10,
  "endDate": null,
  "resultDate": "2027-01-12",
  "resultDayOfWeek": "tuesday",
  "businessDays": 10,
  "calendarDays": 19,
  "weekendDaysSkipped": 6,
  "holidaysSkippedCount": 3,
  "holidaysSkipped": [
    { "date": "2026-12-25", "title": "Christmas Day", "source": "gov.uk" },
    { "date": "2026-12-28", "title": "Boxing Day", "source": "gov.uk" },
    { "date": "2027-01-01", "title": "New Year’s Day", "source": "gov.uk" }
  ],
  "coverageWarning": null,
  "uncoveredYears": [],
  "publishedYears": { "first": 2019, "last": 2028 }
}

Use it from code

Actor ID: cliqtomedia/uk-bank-holidays-business-days. You need your Apify API token from Apify Console → Settings → API & Integrations.

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("cliqtomedia/uk-bank-holidays-business-days").call(run_input={
    "mode": "list",
    "divisions": [
        "england-and-wales",
        "scotland",
        "northern-ireland"
    ]
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

curl -X POST "https://api.apify.com/v2/acts/cliqtomedia~uk-bank-holidays-business-days/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode": "list", "divisions": ["england-and-wales", "scotland", "northern-ireland"]}'

# pip install langchain-apify
# set APIFY_TOKEN in your environment
from langchain_apify import ApifyActorsTool

tool = ApifyActorsTool("cliqtomedia/uk-bank-holidays-business-days")
result = tool.invoke({"run_input": {"mode": "list", "divisions": ["england-and-wales", "scotland", "northern-ireland"]}})
print(result)

The cURL call waits for the results, up to 300 seconds. For longer runs, start a run (/runs) and get the results with a webhook or by checking the run. Apify API docs. LlamaIndex, MCP for AI agents and the JavaScript client: AI agents & MCP.

Similar tools

More in Government & open data.

Open dataLive on Apify

EU TED Tenders Scraper & Monitor

Find EU public tenders on TED with your own filters.

Open dataLive on Apify

UK Postcode Lookup

Paste a list of Great Britain postcodes and get map points and official area codes.

Open dataLive on Apify

USAspending Federal Awards & Recipient Monitor

Find US federal contracts, grants and loans from USAspending.gov.

Open dataLive on Apify

VIN Decoder & Vehicle Recalls

Turn a list of VINs into clean vehicle rows with NHTSA data.

Open dataComing soon

FDA Recalls & Enforcement Monitor

Get FDA recalls for food, drugs and medical devices in one table.

Open dataComing soon

NASA POWER Historical Weather & Solar Data

Get past weather and solar data for any latitude and longitude.