# Holiday Calendar

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

Returns the list of public holidays for a given country and year, distinguishing national from regional entries, sourced from Nager.Date (~110 countries).

## Facts

- Endpoint: GET https://402.com.tr/api/x402/holiday-calendar
- Price: $0.002/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-9a872c86
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LlgGdztiR99J7fHCYdVxO

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-9a872c86
```

Example prompt: Can you pull up the full list of public holidays in Germany for 2025, including which ones are national versus regional?

## When to prefer this

Choose this endpoint when you need the raw public holiday calendar data for a specific country and year — for example, to build custom scheduling logic, render a calendar UI, or join holiday data with other datasets. If you simply need to add or count business days accounting for holidays, the sibling Business Days endpoint may be more convenient. Prefer this endpoint when you want full holiday list access rather than a derived business-day calculation.

## Known failure modes

- Unsupported country code returns an error or empty list — verify the ISO-2 code is among Nager.Date's ~110 supported countries
- Invalid or out-of-range year may return an empty result or error
- Missing required 'country' query parameter results in a 400-level error
- Network or upstream Nager.Date availability issues may cause timeouts

## How this service works

List public holidays for country= + year= from Nager.Date (~110 countries). Marks national vs regional entries. Same source business-days uses — for agents that need the raw calendar.

## Output

A list of public holiday entries for the requested country and year. Each entry includes the holiday date, name, and a flag indicating whether it is a national or regional/local holiday. Covers approximately 110 countries via the Nager.Date data 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"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "country"
     ],
     "properties": {
      "year": {
       "type": "string",
       "description": "Year"
      },
      "country": {
       "type": "string",
       "description": "Country (ISO-2)"
      }
     }
    }
   },
   "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/holiday-calendar-9a872c86/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 402.com.tr](https://www.zero.xyz/host/402.com.tr/llms.txt)