# UK Working Days & Bank Holidays API

> UK Working Days & Bank Holidays API is a paid API for AI agents from uk-data.agent-fee-check.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-12).

Returns a list of UK bank holidays and the count of working days between two dates for a specified UK region

## Facts

- Endpoint: GET https://uk-data.agent-fee-check.workers.dev/working-days/holidays?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uk-working-days-bank-holidays-api-ec5b3808
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nlenWCyLw4jCEYgkiVdC4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability uk-working-days-bank-holidays-api-ec5b3808
```

Example prompt: How many bank holidays are there in England and Wales between 2026-01-01 and 2026-12-31, and can you list them all with their dates?

## When to prefer this

Choose this endpoint when you need authoritative UK bank holiday data sourced directly from GOV.UK for a specific date range and UK jurisdiction, especially when building scheduling, payroll, SLA, or project planning features that require official attribution. Prefer over generic calendar APIs when UK-specific regional distinctions (England and Wales vs Scotland vs Northern Ireland) matter, and when you need pay-per-call pricing without a subscription.

## Known failure modes

- Missing required 'from' or 'to' query parameters returns an error
- Dates in wrong format (not YYYY-MM-DD) cause a parse error
- Invalid region value (not one of england-and-wales, scotland, northern-ireland) returns a validation error
- Date range where 'to' is before 'from' may return empty or error response
- Payment failure via x402 results in a 402 response with a free preview sample but no full data charged

## How this service works

UK public data for AI agents, one origin, pay per call: a one-call postcode report, street crime, live flood warnings, property sales and the House Price Index, food hygiene ratings, MP lookup, NHS GPs, pharmacies and dentists, Companies House checks and search, UK working days and bank holidays, and the cheapest card machine provider. Official sources, attribution in every answer, free preview in every 402, failed requests never charged.

## Output

A JSON object containing the region, the from/to date range, a human-readable summary sentence with the count of bank holidays, and an array of bank holiday objects each with a date (YYYY-MM-DD), day of week, and official title.

## Request schema (JSON Schema)

```json
{
 "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, YYYY-MM-DD"
      },
      "from": {
       "type": "string",
       "description": "First day, YYYY-MM-DD"
      },
      "region": {
       "enum": [
        "england-and-wales",
        "scotland",
        "northern-ireland"
       ],
       "type": "string",
       "description": "england-and-wales (default), scotland or northern-ireland"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uk-working-days-bank-holidays-api-ec5b3808/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from uk-data.agent-fee-check.workers.dev](https://www.zero.xyz/host/uk-data.agent-fee-check.workers.dev/llms.txt)