# WorldData402 Public Holidays Lookup

> WorldData402 Public Holidays Lookup is a paid API for AI agents from worlddata402.worlddata402.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-19).

Returns the list of public holidays for a given country and year

## Facts

- Endpoint: POST https://worlddata402.worlddata402.workers.dev/v1/holidays/%7Bcountry%7D/%7Byear%7D?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/worlddata402-public-holidays-lookup-79d021ff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cZiwMLQpPxV8AiVOu2XWu

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 worlddata402-public-holidays-lookup-79d021ff -d '<json body>'
```

Example prompt: Can you get me the full list of public holidays in Germany for 2025? I need to know all the official national holidays for the year.

## When to prefer this

Use this endpoint when you need official, country-specific public holiday data for scheduling, compliance, payroll, or travel planning. It is a pay-per-call service billed at $0.01 USDC via x402 on Base mainnet, making it cost-effective for sporadic lookups. Prefer this over general web scraping when you need structured, reliable holiday data for international markets.

## Known failure modes

- Invalid or unsupported country code returns an error or empty result
- Year out of supported range returns an error
- Payment not processed (x402 payment failure) results in 402 response
- Malformed request body returns a 400 error
- Rare countries or territories may have incomplete holiday data

## How this service works

Global market, government and reference data for AI agents. Pay-per-call over x402 (USDC on Base mainnet).

## Output

A list of public holidays for the specified country and year, including the holiday name, date, and relevant metadata such as holiday type or observance notes.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/worlddata402-public-holidays-lookup-79d021ff/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from worlddata402.worlddata402.workers.dev](https://www.zero.xyz/host/worlddata402.worlddata402.workers.dev/llms.txt)