# x402.forgemesh.io National Holidays Calendar

> x402.forgemesh.io National Holidays Calendar is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Returns a full public holiday calendar for any country and year as structured JSON, including date, local-language name, English name, and holiday type.

## Facts

- Endpoint: POST https://x402.forgemesh.io/national-holidays-calendar
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-forgemesh-io-national-holidays-calendar-3231e0bb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_80j-VsISxmGyJjSiRKU24

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-forgemesh-io-national-holidays-calendar-3231e0bb -d '<json body>'
```

Example prompt: Give me the full list of public holidays in Germany for 2025 — I need each date, the name in German and in English, and what type of holiday it is.

## When to prefer this

Use this endpoint when you need a machine-readable, structured list of national public holidays for any of 200+ countries and any year — especially for payroll systems, delivery schedulers, SLA calculators, or any workflow that must distinguish business days from holidays. Prefer this over scraping government sites or using locale libraries when you need multilingual names, coverage across many countries, or consistent JSON output.

## Known failure modes

- Invalid or unsupported country code returns error or empty list
- Year out of supported range returns error
- Malformed input schema triggers 400-style error
- Payment failure via x402 protocol blocks request
- Network timeout returns no data

## How this service works

Full public holiday calendar for any of 110+ countries and any year — date, local-language name, English name, whether it's observed nationwide, and which subdivisions recognize it — as structured JSON. Used by payroll systems, delivery schedulers, and SLA calculators that need to know which dates are actually business days.

## Output

A structured JSON object containing all official public holidays for the specified country and year, with each entry including the date, holiday name in the local language, English-translated name, and holiday type/category.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "year": {
   "type": "string",
   "description": "default 2026"
  },
  "country": {
   "type": "string",
   "description": "2-letter code, default US"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "date": "2026-07-03",
    "name": "Independence Day",
    "fixed": true,
    "types": [
     "Public"
    ],
    "global": true,
    "counties": null,
    "localName": "Independence Day",
    "launchYear": null,
    "countryCode": "US"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-forgemesh-io-national-holidays-calendar-3231e0bb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)