# Public Holidays by Country (Nager Date)

> Public Holidays by Country (Nager Date) is a paid API for AI agents from engedi.digi-life17.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

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

## Facts

- Endpoint: GET https://engedi.digi-life17.workers.dev/api/holidays
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/public-holidays-by-country-nager-date-d10d02e0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aj_DJ20VsP53RW1ApnrgP

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 public-holidays-by-country-nager-date-d10d02e0
```

Example prompt: What are all the public holidays in Germany for 2025?

## When to prefer this

Use this endpoint when you need authoritative, structured public holiday data for a specific country and year. Ideal for scheduling apps, business logic that avoids holidays, HR tools, or any agent needing to know if a given date is a holiday in a particular country. Prefer this over manual web searches or scraping since it returns clean, machine-readable JSON directly from the Nager Date dataset.

## Known failure modes

- Missing or invalid country code returns an error — country is a required parameter
- Invalid ISO 3166-1 alpha-2 code may return no results or an error
- Year out of range may return empty data or an error from the upstream Nager Date source
- Upstream Nager Date API unavailability may cause failures or stale cached data
- Payment of 0.005 USDC required per call; unpaid requests will be rejected with 402

## How this service works

51 REST endpoints for AI agents. Weather, news, crypto, stocks, products, courses, real estate, and 42 more. Pay per call in USDC/USDT via x402.

## Output

A structured JSON object containing a list of public holidays for the specified country and year, including holiday names, dates, and metadata such as cache status, data source, confidence score, and last updated timestamp.

## Response schema (JSON Schema)

```json
{}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/public-holidays-by-country-nager-date-d10d02e0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from engedi.digi-life17.workers.dev](https://www.zero.xyz/host/engedi.digi-life17.workers.dev/llms.txt)