# SiteCheck Public Holidays Lookup

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

Returns a list of public holidays for a given country and year using ISO 3166 alpha-2 country codes.

## Facts

- Endpoint: GET https://api.sitecheck-api.workers.dev/api/holidays?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-public-holidays-lookup-a535b1d7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6Zo8E4X8hOpBbi3pYUNLt

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 sitecheck-public-holidays-lookup-a535b1d7
```

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

## When to prefer this

Choose this endpoint when you need structured, machine-readable public holiday data for a specific country and year, particularly when you need regional/county-level granularity (e.g. which holidays apply only to specific German states). It is ideal for scheduling, payroll, compliance, or calendar automation workflows where you need to programmatically check holidays across countries.

## Known failure modes

- Missing or invalid country code returns an error — must be a valid ISO 3166 alpha-2 code
- Year out of range (outside 1900–2100) may return an error or empty result
- Country not supported by Nager.Date returns empty or error response
- Network timeout from underlying Nager.Date API
- Malformed query parameters return validation error

## How this service works

Public holidays of a country (ISO 2 code) for a year (default: this year): date, local and English names, and whether the holiday is nationwide or regional with its counties. Source: Nager.Date. An empty list is a valid answer.

## Output

Returns a JSON object containing the year, country code, total holiday count, source attribution, and an array of holiday objects each with date, English name, local name, list of applicable county/region codes (null if nationwide), and a nationwide boolean flag. Also includes a checkedAt timestamp.

## 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",
     "required": [
      "country"
     ],
     "properties": {
      "year": {
       "type": "string",
       "description": "1900 to 2100 (default: this year)"
      },
      "country": {
       "type": "string",
       "description": "ISO 3166 alpha-2 code, e.g. DE"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "year": 2026,
  "count": 19,
  "source": "Nager.Date public holidays API (https://date.nager.at)",
  "country": "DE",
  "holidays": [
   {
    "date": "2026-01-01",
    "name": "New Year's Day",
    "counties": null,
    "localName": "Neujahr",
    "nationwide": true
   },
   {
    "date": "2026-01-06",
    "name": "Epiphany",
    "counties": [
     "DE-BW",
     "DE-BY"
    ],
    "localName": "Heilige Drei Könige",
    "nationwide": false
   }
  ],
  "checkedAt": "2026-10-14T04:49:24.327Z"
 }
}
```

## More

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