# UK Working Days Calculator

> UK Working Days Calculator is a paid API for AI agents from uk-working-days.agent-fee-check.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-22).

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.

## Facts

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

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-calculator-1fc61438
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## 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) 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"
    }
   }
  }
 }
}
```

## 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-calculator-1fc61438/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from uk-working-days.agent-fee-check.workers.dev](https://www.zero.xyz/host/uk-working-days.agent-fee-check.workers.dev/llms.txt)