# Agent402 UK Holiday Calendar (Static Multi-Region)

> Agent402 UK Holiday Calendar (Static Multi-Region) is a paid API for AI agents from agent402.co.uk, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Returns a static list of public holidays for a given country and year, covering US, DE, FR, IE, JP, AU, and SG, with no external API dependency.

## Facts

- Endpoint: GET https://agent402.co.uk/v1/time/holidays-static
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-uk-holiday-calendar-static-multi-region-f2ab796b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tpTgB02EIimXc6m_IWlBV

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-holiday-calendar-static-multi-region-f2ab796b
```

Example prompt: Can you pull up all public holidays in Germany for 2026? I need the full list with dates and names.

## When to prefer this

Choose this endpoint when you need a fast, offline, zero-dependency holiday lookup for one of the supported countries (US, DE, FR, IE, JP, AU, SG) without relying on external calendar APIs like Nager. Ideal for scheduling, compliance checks, or payroll automation where uptime and deterministic results matter more than exhaustive regional sub-holiday coverage.

## Known failure modes

- Missing required 'country' query parameter returns an error
- Unsupported country code (outside US|DE|FR|IE|JP|AU|SG) returns an error or empty result
- Invalid year format (non-YYYY) may return an error
- Payment of $0.001 USDC required via x402 protocol; missing payment returns 402
- Year out of supported range may return empty or invalid result

## 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 JSON object containing the country code, a count of holidays, a validity flag, and an array of holiday events each with a date (YYYY-MM-DD) and name string. Example: {count: 11, valid: true, country: 'US', events: [{date: '2026-01-01', name: "New Year's Day"}]}.

## 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": [
      "country"
     ],
     "properties": {
      "year": {
       "type": "string",
       "description": "YYYY"
      },
      "country": {
       "type": "string",
       "description": "US|DE|FR|IE|JP|AU|SG"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 11,
  "valid": true,
  "events": [
   {
    "date": "2026-01-01",
    "name": "New Year's Day"
   }
  ],
  "country": "US"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-uk-holiday-calendar-static-multi-region-f2ab796b/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)