# Public Holidays by Country & Year

> Public Holidays by Country & Year is a paid API for AI agents from mcpfax-utility.bowling-anthony.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns the list of official public holidays for a given country and year.

## Facts

- Endpoint: GET https://mcpfax-utility.bowling-anthony.workers.dev/v1/holidays
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/public-holidays-by-country-year-b14cdb90
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B8_WaQ4D95nOFfLeue12z

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-by-country-year-b14cdb90
```

Example prompt: What are all the public holidays in Japan for 2025? I need the full list with dates and holiday names.

## When to prefer this

Use this endpoint when you need a structured, machine-readable list of official public holidays for a specific country and year — especially for scheduling, payroll, travel planning, or date validation workflows. Prefer this over manual lookup or general web search when you need clean, structured data you can programmatically compare against dates.

## Known failure modes

- Unsupported or invalid country code returns an error or empty result
- Year out of supported range returns an error
- Missing required parameters (country or year) returns a validation error
- Network or worker timeout returns a 5xx error

## How this service works

Public holidays — Public holidays for a country & year.

## Output

A list of public holidays for the specified country and year, each including the holiday name, date, and typically the holiday type or category (e.g. national, regional, bank holiday).

## 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"
    }
   },
   "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-by-country-year-b14cdb90/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcpfax-utility.bowling-anthony.workers.dev](https://www.zero.xyz/host/mcpfax-utility.bowling-anthony.workers.dev/llms.txt)