# Euroref Public Holidays by Country

> Euroref Public Holidays by Country is a paid API for AI agents from euroref.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-23).

Returns European public holidays for a given country, with official gazette citations, dates, names, source URLs, and confirmation status, optionally filtered by year.

## Facts

- Endpoint: GET https://euroref.dev/v1/holidays/:country?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/euroref-public-holidays-by-country-590c69ba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FvOgjKqVuTSiFbcTbJ6O0

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 euroref-public-holidays-by-country-590c69ba
```

Example prompt: What are all the official public holidays in Germany for 2025, with their sources from the official gazette?

## When to prefer this

Choose this endpoint when you need authoritative, citation-backed public holiday data for European countries — especially when compliance, payroll, or legal accuracy matters and you need to trace each holiday back to its official government source. Prefer this over generic holiday APIs when source provenance (official gazette URLs) and confirmation timestamps are required.

## Known failure modes

- Unsupported or invalid country code returns a 404 or error response
- Country outside European coverage scope returns no results
- Invalid year format in query parameter may return an error or unfiltered results
- Stale confirmation date if a holiday has been changed by legislation since last crawl

## How this service works

European public holidays by country, cited to the official gazette or government source: date, name, source URL, last_confirmed. ?year=YYYY to filter. GET /v1/holidays/{country}, e.g. /v1/holidays/de.

## Output

A JSON array of public holiday records for the requested country, each containing the date, localized holiday name, official source URL (e.g. government gazette), and a last_confirmed timestamp indicating when the data was last verified. Optionally scoped to a single calendar year via the ?year=YYYY query parameter.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {},
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/euroref-public-holidays-by-country-590c69ba/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from euroref.dev](https://www.zero.xyz/host/euroref.dev/llms.txt)