# public-holidays-united-kingdom

> public-holidays-united-kingdom is a paid API for AI agents from intel.rallylive.ca, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-23).

Returns all public holidays in the United Kingdom for a specified year, including dates, names, regional scope, and weekday information.

## Facts

- Endpoint: GET https://intel.rallylive.ca/data/holidays/gb?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/public-holidays-united-kingdom-9c3a3551
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_an_jvTIwMyLTBM3Rh0rN-

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 public-holidays-united-kingdom-9c3a3551
```

Example prompt: Can you get me the full list of public holidays in the United Kingdom for 2025, including which ones are only observed in certain regions like Scotland or Northern Ireland?

## When to prefer this

Choose this endpoint when you need structured, machine-readable UK public holiday data without setting up an API key, particularly for scheduling, business-day calculation, or SLA enforcement. It is ideal for agents that need to check whether a specific date falls on a UK public holiday or need to enumerate all holidays in a given year, including regional distinctions across England, Scotland, Wales, and Northern Ireland. At $0.01 per call, it is cost-effective for occasional lookups.

## Known failure modes

- Invalid or missing year parameter may return an error or empty result
- Network timeout if the upstream Nager.Date dataset is unavailable
- Payment failure if the $0.01 USDC x402 payment is not completed correctly
- Unsupported year ranges (very far future or historical) may return incomplete data

## How this service works

Public holidays in United Kingdom for a given year: every national and regional public holiday with date, local and English names, whether it is nationwide or which regions observe it, and the weekday, from the Nager.Date public holiday dataset. Business-day and scheduling checks for United Kingdom without an API key. $0.01 per year.

## Output

A list of public holidays in the United Kingdom for the requested year, where each entry includes the date, local name, English name, a flag indicating if it is nationwide or region-specific, the list of regions (e.g. England, Scotland, Wales, Northern Ireland) that observe it, and the day of the week.

## 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": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/public-holidays-united-kingdom-9c3a3551/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from intel.rallylive.ca](https://www.zero.xyz/host/intel.rallylive.ca/llms.txt)
