# lookups.nl Public Holidays

> lookups.nl Public Holidays is a paid API for AI agents from lookups.nl, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns statutory public holidays for a given country and year, including each date, English and local name, and nationwide applicability.

## Facts

- Endpoint: GET https://lookups.nl/holidays/:query
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lookups-nl-public-holidays-4deaff67
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zJzVk_Y4LtWytzxDhEA9s

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 lookups-nl-public-holidays-4deaff67
```

Example prompt: What are all the statutory public holidays in the Netherlands for 2026 — give me each date, the official English and Dutch name, and whether it applies nationwide?

## When to prefer this

Choose this endpoint when you need authoritative statutory public holidays only — not bank, school, or observance days — for any of 202 countries across a narrow year range. It is ideal for payroll systems, scheduling tools, and compliance checks where only legally mandated national holidays matter. Prefer it over general calendar APIs when you need both English and local-language holiday names and nationwide applicability flags in a single structured call.

## Known failure modes

- Invalid or unsupported country code returns an error or empty result
- Year outside supported range (current -1 to +2) may return no data
- Malformed COUNTRY-YEAR composite query (e.g. missing hyphen or wrong format) causes a parse error
- Country with no registered holidays returns an empty list
- Network timeout or service unavailability returns a generic HTTP error

## How this service works

Public holidays for a country and year, queried as a composite COUNTRY-YEAR code (e.g. NL-2026): each date with its English and local name and whether it applies nationwide. Statutory public holidays only — bank, school and observance days are excluded. Source: Nager.Date, 202 countries, current year -1 to +2.

## Output

A list of statutory public holidays for the queried country and year. Each entry includes the calendar date, the holiday's English name, its local-language name, and a boolean indicating whether the holiday is nationwide. Bank holidays, school closures, and observance-only days are excluded. Covers 202 countries for the current year minus one through current year plus two.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lookups-nl-public-holidays-4deaff67/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from lookups.nl](https://www.zero.xyz/host/lookups.nl/llms.txt)