# Agent402 UK Bank Holidays

> Agent402 UK Bank Holidays is a paid API for AI agents from agent402.co.uk, paid per call via x402, $0.001/call, status down (last checked 2026-09-15).

Returns official UK public bank holidays for England & Wales, Scotland, and Northern Ireland from GOV.UK, filterable by region and date range.

## Facts

- Endpoint: GET https://agent402.co.uk/v1/uk/bank-holidays
- Price: $0.001/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-uk-bank-holidays-fbdaf8ea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EJqFuCK6RYotci8kuurAu

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 agent402-uk-bank-holidays-fbdaf8ea
```

Example prompt: Can you get me all the bank holidays in England and Wales for 2025 so I can flag them in our payroll calendar?

## When to prefer this

Use this endpoint when you need authoritative, government-sourced UK bank holiday data for any of the three UK divisions. It is ideal for payroll systems, financial settlement scheduling (e.g. CHAPS), SLA calendars, and any workflow that must exclude UK public holidays. Prefer this over generic calendar APIs when UK-specific legal accuracy and division-level granularity (England & Wales vs Scotland vs Northern Ireland) are required.

## Known failure modes

- Invalid division value returns an error — must be one of: england-and-wales, scotland, northern-ireland, or all
- Malformed date format for from/to parameters causes a parsing error
- Requesting dates far outside the GOV.UK published range may return an empty result set
- Network or upstream GOV.UK API unavailability may cause a service error

## How this service works

Don't burn tokens on deterministic work. Go/no-go jobs first: payout preflight, text firewall (PII/secrets), budget check — then rails, calendars, finmath. x402 USDC on Base. UK + global. agent402.co.uk — not agent402.tools. $0.001–$0.002 USDC on Base. No API keys.

## Output

A structured JSON list of bank holidays for the requested UK division(s) and date range, sourced from GOV.UK OGL data. Each entry includes the holiday name and date. Results can be filtered by region (england-and-wales, scotland, northern-ireland, or all) and optionally scoped to a specific year or date range.

## 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",
     "properties": {
      "to": {
       "type": "string",
       "description": "To YYYY-MM-DD inclusive"
      },
      "from": {
       "type": "string",
       "description": "From YYYY-MM-DD inclusive"
      },
      "year": {
       "type": "string",
       "description": "Calendar year filter"
      },
      "region": {
       "type": "string",
       "description": "Alias for division"
      },
      "division": {
       "type": "string",
       "description": "england-and-wales | scotland | northern-ireland (or all)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 8,
  "events": [
   {
    "date": "2026-01-01",
    "title": "New Year’s Day",
    "division": "england-and-wales"
   }
  ],
  "source": "https://www.gov.uk/bank-holidays.json"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-uk-bank-holidays-fbdaf8ea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.co.uk](https://www.zero.xyz/host/agent402.co.uk/llms.txt)