# 402utils Holiday API

> 402utils Holiday API is a paid API for AI agents from 402utils.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-12).

Returns verified public and bank holidays for 8 countries (FR, DE, GB, US, ES, IT, NL, BE) for years 2025–2027, with optional sub-national region support

## Facts

- Endpoint: GET https://402utils.com/v1/holidays?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/402utils-holiday-api-36a1e4b2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AeoSsKgFIHBpBepHs5-Vk

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 402utils-holiday-api-36a1e4b2
```

Example prompt: Can you get me a list of all official public holidays in Germany for 2025, including regional ones for Bavaria (DE-BY)?

## When to prefer this

Choose this endpoint when you need authoritative, government-source-verified holiday data for one of the 8 supported European/US countries in years 2025–2027, especially when you need sub-national precision (German Länder, UK divisions, Alsace-Moselle). Prefer it over generic calendar APIs when accuracy against official sources and movable feast computation correctness matters.

## Known failure modes

- Unsupported country code returns an error — only FR, DE, GB, US, ES, IT, NL, BE are supported
- Year outside 2025–2027 range returns an error — no historical or future data beyond verified window
- Invalid or unrecognized region code may return an error or fall back to national holidays
- Missing required query parameters (country or year) returns a 400-level error
- Payment failure (x402) returns a 402 status if USDC payment is not completed

## How this service works

Public and bank holidays for FR, DE, GB, US, ES, IT, NL, BE — years 2025-2027, each dataset verified against the country's official source (Etalab, Land statutes, gov.uk feed, OPM, BOE, normattiva, rijksoverheid, SPF Emploi). Movable feasts are computed (Gregorian computus), substitute days follow each country's official rule. Optional ?region= for sub-national holidays (German Länder, UK divisions, Alsace-Moselle).

## Output

A JSON object containing the country code, year, optional region, and an array of holiday objects — each with date (YYYY-MM-DD), English name, local name, type (public/bank/observance), optional regional applicability array, and optional dataset-level notes. Data is verified against each country's official source.

## 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",
      "year"
     ],
     "properties": {
      "year": {
       "type": "integer",
       "description": "2025-2027 (verified data window)."
      },
      "region": {
       "type": "string",
       "description": "Optional ISO 3166-2 region for regional holidays (e.g. DE-BY, GB-SCT, FR-57)."
      },
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2: FR, DE, GB, US, ES, IT, NL, BE."
      }
     },
     "description": "Query params. `country` and `year` required."
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "country",
      "year",
      "holidays"
     ],
     "properties": {
      "note": {
       "type": "string",
       "description": "Dataset-level caveat when applicable."
      },
      "year": {
       "type": "integer"
      },
      "region": {
       "type": "string"
      },
      "country": {
       "type": "string"
      },
      "holidays": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "date",
         "name",
         "localName",
         "type"
        ],
        "properties": {
         "date": {
          "type": "string",
          "description": "YYYY-MM-DD."
         },
         "name": {
          "type": "string",
          "description": "English name."
         },
         "note": {
          "type": "string"
         },
         "type": {
          "type": "string",
          "description": "public | bank | observance."
         },
         "regions": {
          "type": "array",
          "items": {
           "type": "string"
          },
          "description": "Present when the holiday is regional."
         },
         "localName": {
          "type": "string"
         }
        }
       }
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "year": 2026,
  "country": "FR",
  "holidays": [
   {
    "date": "2026-01-01",
    "name": "New Year's Day",
    "type": "public",
    "localName": "Jour de l'an"
   },
   {
    "date": "2026-04-06",
    "name": "Easter Monday",
    "type": "public",
    "localName": "Lundi de Pâques"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/402utils-holiday-api-36a1e4b2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 402utils.com](https://www.zero.xyz/host/402utils.com/llms.txt)