# UK Bank Holidays Scraper (`parseforge/gov-uk-bank-holidays-scraper`) Actor

Export official UK bank holidays for England-Wales, Scotland, and Northern Ireland. Returns title, date, substitute-day notes, bunting flag per division per year. Sourced from the GOV.UK open data feed.

- **URL**: https://apify.com/parseforge/gov-uk-bank-holidays-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Business, Automation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $9.00 / 1,000 result items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 🇬🇧 GOV.UK Bank Holidays Scraper

> 🚀 **Export the official UK bank holiday calendar in seconds.** Pull every past and upcoming holiday for **England & Wales, Scotland, and Northern Ireland** from the canonical gov.uk feed. No API key, no registration, no manual calendar wrangling.

> 🕒 **Last updated:** 2026-05-22 · **📊 9 fields** per record · **🇬🇧 3 divisions** · **📅 15+ years coverage** · **🎏 50+ holidays per division**

The **GOV.UK Bank Holidays Scraper** exports the canonical UK public-holiday calendar published by the Government Digital Service and returns **9 fields per record**, including title, ISO date, year, weekday, division, notes, bunting flag, substitute-day flag, and the scrape timestamp. The underlying feed is the authoritative reference for UK payroll, banking, scheduling, and HR systems.

The dataset covers **England & Wales, Scotland, and Northern Ireland separately**, with each division carrying its own statutory calendar. Past holidays and several years of upcoming dates are returned in a single run, ready for downstream payroll, scheduling, or compliance pipelines. This Actor turns the calendar into downloadable CSV, Excel, JSON, or XML in under a minute.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| UK payroll and HR teams, fintech and banking ops, scheduling and rota apps, logistics and delivery platforms, retail and hospitality | Payroll calculations, working-day calendars, settlement-date logic, courier SLAs, store-opening rosters, holiday-aware booking flows |

---

### 📋 What the GOV.UK Bank Holidays Scraper does

Three filtering workflows in a single run:

- 🇬🇧 **All divisions.** Pull every holiday across England & Wales, Scotland, and Northern Ireland.
- 🏴 **Single division.** Restrict to one nation, useful for region-specific payroll or scheduling logic.
- 📅 **Year window.** Limit to a date range, for example just the upcoming three years or a historical lookback.

Each record includes the official holiday title, the ISO date, the year extracted from the date, the weekday name, the division code (`england-and-wales`, `scotland`, `northern-ireland`), the human-friendly division label, any notes (such as substitute-day notices), the bunting flag indicating whether bunting is traditionally displayed, the substitute-day flag derived from the notes, and the scrape timestamp.

> 💡 **Why it matters:** UK payroll, banking, and scheduling pipelines all depend on the canonical bank-holiday calendar. Building your own feed parser means handling JSON updates, division-specific differences, and substitute days. This Actor skips all of that and refreshes on every run.

---

### 🎬 Full Demo

_🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset._

---

### ⚙️ Input

<table>
<thead>
<tr><th>Input</th><th>Type</th><th>Default</th><th>Behavior</th></tr>
</thead>
<tbody>
<tr><td><code>maxItems</code></td><td>integer</td><td><code>10</code></td><td>Records to return. Free plan caps at 10, paid plan at 1,000,000.</td></tr>
<tr><td><code>division</code></td><td>string</td><td><code>"all-divisions"</code></td><td>One of <code>all-divisions</code>, <code>england-and-wales</code>, <code>scotland</code>, <code>northern-ireland</code>.</td></tr>
<tr><td><code>yearFrom</code></td><td>integer</td><td><code>null</code></td><td>Earliest holiday year (inclusive). Empty = all available.</td></tr>
<tr><td><code>yearTo</code></td><td>integer</td><td><code>null</code></td><td>Latest holiday year (inclusive).</td></tr>
</tbody>
</table>

**Example: every upcoming holiday for England & Wales through 2028.**

```json
{
    "maxItems": 100,
    "division": "england-and-wales",
    "yearFrom": 2026,
    "yearTo": 2028
}
````

**Example: every Scottish bank holiday in 2026.**

```json
{
    "maxItems": 20,
    "division": "scotland",
    "yearFrom": 2026,
    "yearTo": 2026
}
```

> ⚠️ **Good to Know:** the feed publishes a rolling window of past and upcoming holidays. For long-range planning, run this Actor weekly or monthly so new years and any substitute-day changes show up in your downstream calendar.

***

### 📊 Output

Each holiday record contains **9 fields**. Download the dataset as CSV, Excel, JSON, or XML.

#### 🧾 Schema

| Field | Type | Example |
|---|---|---|
| 🎏 `title` | string | `"Christmas Day"` |
| 📅 `date` | string (YYYY-MM-DD) | `"2026-12-25"` |
| 📆 `year` | number | `2026` |
| 🗓️ `weekday` | string | `"Friday"` |
| 🏴 `division` | string | `"england-and-wales"` |
| 🇬🇧 `divisionLabel` | string | `"England & Wales"` |
| 📝 `notes` | string | null | `"Substitute day"` |
| 🎉 `bunting` | boolean | `true` |
| 🔁 `isSubstituteDay` | boolean | `false` |
| 🕒 `scrapedAt` | ISO 8601 | `"2026-05-22T10:00:00.000Z"` |

#### 📦 Sample records

<details>
<summary><strong>🎄 Christmas Day 2026 in England & Wales</strong></summary>

```json
{
    "title": "Christmas Day",
    "date": "2026-12-25",
    "year": 2026,
    "weekday": "Friday",
    "division": "england-and-wales",
    "divisionLabel": "England & Wales",
    "notes": null,
    "bunting": true,
    "isSubstituteDay": false,
    "scrapedAt": "2026-05-22T10:00:00.000Z"
}
```

</details>

<details>
<summary><strong>🏴 St Andrew's Day 2026 in Scotland</strong></summary>

```json
{
    "title": "St Andrew's Day",
    "date": "2026-11-30",
    "year": 2026,
    "weekday": "Monday",
    "division": "scotland",
    "divisionLabel": "Scotland",
    "notes": null,
    "bunting": true,
    "isSubstituteDay": false,
    "scrapedAt": "2026-05-22T10:00:00.000Z"
}
```

</details>

***

### ✨ Why choose this Actor

| | Capability |
|---|---|
| 🇬🇧 | **Canonical source.** Pulls direct from the gov.uk bank-holiday feed published by the Government Digital Service. |
| 🏴 | **Per-division.** England & Wales, Scotland, and Northern Ireland each carry their own statutory calendar. |
| 📅 | **Past and future.** Multiple years of historical and upcoming holidays in a single run. |
| ⚡ | **Fast.** Full dataset in under 10 seconds. |
| 🔁 | **Substitute-day flag.** The Actor flags substitute weekday holidays so payroll logic stays correct. |
| 🔁 | **Always fresh.** Each run pulls the latest feed, so the dataset reflects any recent calendar updates. |
| 🚫 | **No authentication.** Works against the public gov.uk feed. No login or API key needed. |

> 📊 An accurate bank-holiday calendar is the backbone of UK payroll runs, banking settlement, courier SLAs, and store rosters.

***

### 📈 How it compares to alternatives

| Approach | Cost | Coverage | Refresh | Setup |
|---|---|---|---|---|
| **⭐ GOV.UK Bank Holidays Scraper** *(this Actor)* | $5 free credit, then pay-per-use | **3 divisions, 15+ years** | **Live per run** | ⚡ 2 min |
| Hard-coded calendar in your codebase | Free | Stale within a year | Manual | 🐢 Tech debt |
| In-house gov.uk feed parser | Free + engineering | Full | Build it yourself | 🛠️ Hours |
| Commercial holiday APIs | $9+/month | Global | Daily | ⏳ Hours |

Pick this Actor when you want a canonical UK calendar with zero parser maintenance and zero per-API-call billing.

***

### 🚀 How to use

1. 📝 **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes).
2. 🌐 **Open the Actor.** Go to the GOV.UK Bank Holidays Scraper page on the Apify Store.
3. 🎯 **Set input.** Pick a division (or all) and optionally set a year range. Set `maxItems`.
4. 🚀 **Run it.** Click **Start** and let the Actor collect your data.
5. 📥 **Download.** Grab your results in the **Dataset** tab as CSV, Excel, JSON, or XML.

> ⏱️ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required.

***

### 💼 Business use cases

<table>
<tr>
<td width="50%" valign="top">

#### 💼 Payroll & HR

- Working-day calendars for monthly payroll
- Pro-rata pay calculations for new starters
- Holiday-aware time-off accrual logic
- Bank-holiday overtime rate tables

</td>
<td width="50%" valign="top">

#### 🏦 Banking & Fintech

- BACS and CHAPS settlement-date logic
- Direct-debit calendar checks
- Trade-date and value-date calculators
- Card-network business-day handling

</td>
</tr>
<tr>
<td width="50%" valign="top">

#### 🚚 Logistics & Delivery

- Courier SLA business-day logic
- Warehouse rota planning
- Customer ETA calculators
- Cross-border delivery cutoffs

</td>
<td width="50%" valign="top">

#### 🛍️ Retail & Hospitality

- Store-opening hour overrides
- Seasonal staffing forecasts
- Promotion timing aligned to long weekends
- Booking-flow availability calendars

</td>
</tr>
</table>

***

### 🔌 Automating GOV.UK Bank Holidays Scraper

Control the scraper programmatically for scheduled runs and pipeline integrations:

- 🟢 **Node.js.** Install the `apify-client` NPM package.
- 🐍 **Python.** Use the `apify-client` PyPI package.
- 📚 See the [Apify API documentation](https://docs.apify.com/api/v2) for full details.

The [Apify Schedules feature](https://docs.apify.com/platform/schedules) lets you trigger this Actor on any cron interval. Weekly or monthly pulls keep downstream payroll and scheduling calendars in sync automatically.

***

### 🌟 Beyond business use cases

UK calendar data powers more than enterprise workflows. The same structured records support research, education, civic projects, and personal initiatives.

<table>
<tr>
<td width="50%">

#### 🎓 Research and academia

- Labour economics studies on long-weekend effects
- Public administration coursework on UK policy
- Historical patterns of statutory holiday changes
- Reproducible datasets cited in papers

</td>
<td width="50%">

#### 🎨 Personal and creative

- Personal calendars and reminder apps
- Travel planning tools for UK trips
- "Days off in 2026" content for creators
- Hobbyist scheduling experiments

</td>
</tr>
<tr>
<td width="50%">

#### 🤝 Non-profit and civic

- Community event scheduling tools
- Volunteer rota apps with holiday awareness
- Local-council operations support
- Civic literacy and government-transparency datasets

</td>
<td width="50%">

#### 🧪 Experimentation

- Test working-day libraries against real data
- Prototype agents that compute deadlines
- Build calendar chrome extensions
- Validate scheduling product logic with real holidays

</td>
</tr>
</table>

***

### 🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

- 💬 [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20GOV.UK%20Bank%20Holidays%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🧠 [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20GOV.UK%20Bank%20Holidays%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🔍 [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20GOV.UK%20Bank%20Holidays%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🅒 [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20GOV.UK%20Bank%20Holidays%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)

***

### ❓ Frequently Asked Questions

#### 🧩 How does it work?

Pick a division, optionally set a year range, click Start, and the Actor reads the canonical gov.uk bank-holiday feed and emits a clean structured record per holiday. No browser automation, no captchas, no setup.

#### 📏 How accurate is the data?

The Actor pulls direct from the canonical gov.uk feed published by the Government Digital Service. The feed is the same source banks, payroll providers, and major UK platforms rely on.

#### 🔁 How often is the dataset refreshed?

The feed updates when new years are published and when substitute days are added. Every run of this Actor pulls the live feed, so your dataset reflects the latest official calendar.

#### 🏴 Why are there separate divisions?

Each UK constituent nation has its own statutory bank-holiday calendar. Scotland and Northern Ireland include holidays not observed in England & Wales (St Andrew's Day, Battle of the Boyne). Filter by division to match your payroll or scheduling region.

#### ⏰ Can I schedule regular runs?

Yes. Use Apify Schedules to run this Actor on any cron interval (weekly, monthly) and keep your downstream calendar in sync.

#### ⚖️ Is this data legal to use?

The feed is published under the UK Open Government Licence (OGL v3.0), which permits commercial and non-commercial reuse with attribution.

#### 💼 Can I use this data commercially?

Yes. The Open Government Licence permits commercial use with attribution. You are responsible for the attribution requirements in your downstream product.

#### 💳 Do I need a paid Apify plan to use this Actor?

No. The free Apify plan is enough for testing and small runs (10 records per run). A paid plan lifts the limit and gives you access to scheduling, higher concurrency, and larger datasets.

#### 🔁 What if a new substitute day is added mid-year?

The Actor re-reads the feed on every run, so substitute-day updates appear automatically. Schedule a monthly refresh and downstream calendars stay accurate.

#### 🌍 Does it include holidays for other countries?

This Actor covers the UK only. For other national calendars, reach out via the contact form below to request a companion scraper.

#### 🆘 What if I need help?

Our support team is here to help. Contact us through the Apify platform or use the Tally form linked below.

***

### 🔌 Integrate with any app

GOV.UK Bank Holidays Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations):

- [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows
- [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps
- [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications in your channels
- [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe holiday data into your warehouse
- [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits and releases
- [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets straight to Sheets

You can also use webhooks to trigger downstream actions when a run finishes. Push fresh holiday data into your payroll system, or alert your team in Slack.

***

### 🔗 Recommended Actors

- [**💱 Frankfurter FX Rates Scraper**](https://apify.com/parseforge/frankfurter-fx-rates-scraper) - ECB-derived daily foreign-exchange rates
- [**📈 Indexmundi Scraper**](https://apify.com/parseforge/indexmundi-scraper) - Global demographic and economic indicators
- [**🛬 OurAirports Global Airport Database Scraper**](https://apify.com/parseforge/ourairports-scraper) - Global aviation reference dataset
- [**🌦️ NOAA Weather Scraper**](https://apify.com/parseforge/noaa-weather-scraper) - Official U.S. weather observations
- [**🗺️ Nominatim OSM Scraper**](https://apify.com/parseforge/nominatim-osm-scraper) - Geocode addresses via OpenStreetMap

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more reference-data scrapers.

***

**🆘 Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue.

***

> **⚠️ Disclaimer:** this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by the UK Government, GOV.UK, or the Government Digital Service. All trademarks mentioned are the property of their respective owners. Only publicly available open calendar data is collected.

# Actor input Schema

## `maxItems` (type: `integer`):

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

## `division` (type: `string`):

UK constituent nation. Each division has its own bank-holiday calendar.

## `yearFrom` (type: `integer`):

Earliest holiday year (inclusive). Leave empty to include all years available in the feed.

## `yearTo` (type: `integer`):

Latest holiday year (inclusive).

## Actor input object example

```json
{
  "maxItems": 10,
  "division": "all-divisions"
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxItems": 10,
    "division": "all-divisions"
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/gov-uk-bank-holidays-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "maxItems": 10,
    "division": "all-divisions",
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/gov-uk-bank-holidays-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "maxItems": 10,
  "division": "all-divisions"
}' |
apify call parseforge/gov-uk-bank-holidays-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/gov-uk-bank-holidays-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "UK Bank Holidays Scraper",
        "description": "Export official UK bank holidays for England-Wales, Scotland, and Northern Ireland. Returns title, date, substitute-day notes, bunting flag per division per year. Sourced from the GOV.UK open data feed.",
        "version": "1.0",
        "x-build-id": "gfD5Xm5tADYMiBjJB"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~gov-uk-bank-holidays-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-gov-uk-bank-holidays-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/parseforge~gov-uk-bank-holidays-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-gov-uk-bank-holidays-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/parseforge~gov-uk-bank-holidays-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-gov-uk-bank-holidays-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
                    },
                    "division": {
                        "title": "Division",
                        "enum": [
                            "all-divisions",
                            "england-and-wales",
                            "scotland",
                            "northern-ireland"
                        ],
                        "type": "string",
                        "description": "UK constituent nation. Each division has its own bank-holiday calendar."
                    },
                    "yearFrom": {
                        "title": "Year From",
                        "minimum": 2010,
                        "maximum": 2100,
                        "type": "integer",
                        "description": "Earliest holiday year (inclusive). Leave empty to include all years available in the feed."
                    },
                    "yearTo": {
                        "title": "Year To",
                        "minimum": 2010,
                        "maximum": 2100,
                        "type": "integer",
                        "description": "Latest holiday year (inclusive)."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
