# x402 Utils – Public Holidays by Country

> x402 Utils – Public Holidays by Country is a paid API for AI agents from utils.kagurazaka.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-29).

Returns all holidays for a given country (and optionally a state/region) in a specified year, including each holiday's date, name, and type (public, bank, school, optional, observance).

## Facts

- Endpoint: GET https://utils.kagurazaka.dev/v1/holidays?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-utils-public-holidays-by-country-0a8439fb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0Nm9qC9-kpGIotPlbGp56

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 x402-utils-public-holidays-by-country-0a8439fb
```

Example prompt: What are all the public holidays in Japan for 2026? Give me the date, name, and type for each one, in English.

## When to prefer this

Use this endpoint when you need a structured, machine-readable list of holidays for any of ~200 countries, with optional filtering by state/region and language. It is ideal for calendar integrations, HR scheduling, travel planning, or any application that needs to programmatically reason about public, bank, school, or observance holidays. Prefer this over scraping government websites or hardcoding holiday lists.

## Known failure modes

- Missing or invalid country code returns an error — must be a valid ISO 3166-1 alpha-2 code
- Invalid or out-of-range year (outside 1970–2100) returns an error
- Invalid state/region code may return no state-specific holidays or an error
- Unsupported language code may fall back to the default language
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Holidays of a country (and optionally a state or region) in a year, with date, name and type (public, bank, school, optional, observance), from the date-holidays data for about 200 countries.

## Output

A JSON object containing the year, country code, a list of holidays (each with date in YYYY-MM-DD format, name in the requested language, and type such as public/bank/school/optional/observance), and a count of public holidays.

## 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": {
      "lang": {
       "type": "string",
       "description": "language of the names, such as en or ja"
      },
      "year": {
       "type": "integer",
       "description": "the year (1970-2100), default this year"
      },
      "state": {
       "type": "string",
       "description": "state or region code, such as CA for the US"
      },
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2 code, such as JP, US, DE"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "year": {},
      "country": {},
      "holidays": {},
      "public_holidays": {}
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "year": 2026,
  "country": "JP",
  "holidays": [
   {
    "date": "2026-01-01",
    "name": "New Year's Day",
    "type": "public"
   }
  ],
  "public_holidays": 16
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-utils-public-holidays-by-country-0a8439fb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from utils.kagurazaka.dev](https://www.zero.xyz/host/utils.kagurazaka.dev/llms.txt)