# Holiday Calendar API – Single Date Holiday Check

> Holiday Calendar API – Single Date Holiday Check is a paid API for AI agents from holidays.use.x402atlas.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Checks whether a specific ISO date is a public holiday in a given country or regional subdivision, returning holiday details.

## Facts

- Endpoint: GET https://holidays.use.x402atlas.com/check
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/holiday-calendar-api-single-date-holiday-check-656e6560
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_45HzR9mVHtEL1uFBr-Edv

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 holiday-calendar-api-single-date-holiday-check-656e6560
```

Example prompt: Is December 26th 2025 an official public holiday in Germany, specifically in Bavaria (DE-BY)?

## When to prefer this

Use this endpoint when you need a single yes/no answer about whether one specific date is a public holiday in a supported country or subdivision. It is ideal for real-time checks during scheduling, payroll, compliance validation, or delivery planning workflows. Prefer it over the full-year listing endpoint when you only need to check one date and want minimal latency and cost. It supports regional subdivisions, making it more precise than country-level-only checkers.

## Known failure modes

- Unsupported country code returns an error — only 37 specific ISO 3166-1 alpha-2 codes are accepted
- Invalid date format returns a validation error — must be ISO 8601 YYYY-MM-DD
- Invalid subdivision code (not matching the selected country prefix) returns an error
- Payment failure or insufficient USDC balance results in a 402 Payment Required response
- Subdivision not found for the given country returns an empty or error response

## How this service works

Holiday date check by country or subdivision — determine whether one ISO date is an official public holiday.

## Output

Returns a JSON object with the queried country, date, a boolean is_holiday flag, and an array of matching holiday objects. Each holiday includes its name (optionally localized), type (e.g. public, bank), start and end dates, whether it is nationwide, and which subdivisions observe it.

## 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",
      "date"
     ],
     "properties": {
      "date": {
       "type": "string",
       "format": "date",
       "description": "ISO calendar date"
      },
      "country": {
       "enum": [
        "AD",
        "AL",
        "AT",
        "BE",
        "BG",
        "BR",
        "BY",
        "CH",
        "CZ",
        "DE",
        "EE",
        "ES",
        "FR",
        "HR",
        "HU",
        "IE",
        "IT",
        "LI",
        "LT",
        "LU",
        "LV",
        "MC",
        "MD",
        "MT",
        "MX",
        "NL",
        "PL",
        "PT",
        "RO",
        "RS",
        "SE",
        "SI",
        "SK",
        "SM",
        "VA",
        "ZA"
       ],
       "type": "string",
       "description": "Supported ISO 3166-1 alpha-2 country code: AD Andorra; AL Albania; AT Austria; BE Belgium; BG Bulgaria; BR Brazil; BY Belarus; CH Switzerland; CZ Czechia; DE Germany; EE Estonia; ES Spain; FR France; HR Croatia; HU Hungary; IE Ireland; IT Italy; LI Liechtenstein; LT Lithuania; LU Luxembourg; LV Latvia; MC Monaco; MD Moldova; MT Malta; MX Mexico; NL Netherlands; PL Poland; PT Portugal; RO Romania; RS Serbia; SE Sweden; SI Slovenia; SK Slovakia; SM San Marino; VA Vatican City; ZA South Africa."
      },
      "language": {
       "type": "string",
       "pattern": "^[A-Z]{2}$",
       "description": "Optional two-letter ISO 639-1 result language. Defaults to English when available."
      },
      "subdivision": {
       "type": "string",
       "pattern": "^[A-Z]{2}-.+$",
       "maxLength": 20,
       "description": "Optional regional subdivision code beginning with the selected country code, for example DE-BE."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "country",
      "date",
      "is_holiday",
      "holidays",
      "queried_at"
     ],
     "propert
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "date": "2026-01-01",
  "country": "DE",
  "holidays": [
   {
    "name": "New Year's Day",
    "type": "Public",
    "end_date": "2026-01-01",
    "nationwide": true,
    "start_date": "2026-01-01",
    "subdivisions": [],
    "regional_scope": "National",
    "temporal_scope": "FullDay"
   }
  ],
  "language": "EN",
  "is_holiday": true,
  "queried_at": "2026-07-27T12:00:00Z",
  "subdivision": "DE-BE"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/holiday-calendar-api-single-date-holiday-check-656e6560/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from holidays.use.x402atlas.com](https://www.zero.xyz/host/holidays.use.x402atlas.com/llms.txt)