# Nager.Date Public Holidays Lookup

> Nager.Date Public Holidays Lookup is a paid API for AI agents from holidays.hergertsynthora.com, paid per call via x402, $0.008/call, status down (last checked 2026-09-13).

Returns the list of public holidays for a given country and year using the Nager.Date API

## Facts

- Endpoint: POST https://holidays.hergertsynthora.com/service
- Price: $0.008/call
- Payment: x402
- Status: down
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nager-date-public-holidays-lookup-63106c83
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_d-hL4H99HNwu2o_Ra9_mc

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 nager-date-public-holidays-lookup-63106c83 -d '<json body>'
```

Example prompt: Can you get me the full list of public holidays in Germany for 2025?

## When to prefer this

Use this endpoint when you need a simple, keyless, deterministic lookup of official public holidays for any country and year. Ideal for calendar applications, scheduling tools, or any workflow that needs to avoid scheduling on public holidays. Prefer this over scraping government sites or maintaining your own holiday database.

## Known failure modes

- Invalid or unsupported country code returns an error or empty result
- Year out of supported range may return no data
- Missing required fields (year or countryCode) cause a validation error
- Upstream Nager.Date API failure results in no charge but an error response
- Wallet header missing or malformed may result in payment/auth rejection

## How this service works

Public holidays for any country and year via the Nager.Date API. Deterministic, keyless.

## Output

An array of public holiday objects for the specified country and year, including holiday dates and names, sourced from the Nager.Date dataset. Results are deterministic and do not vary between calls for the same input.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "year",
  "countryCode"
 ],
 "properties": {
  "year": {
   "type": "integer",
   "description": "year"
  },
  "countryCode": {
   "type": "string",
   "description": "countryCode"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nager-date-public-holidays-lookup-63106c83/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from holidays.hergertsynthora.com](https://www.zero.xyz/host/holidays.hergertsynthora.com/llms.txt)