# AgentShelf Holiday Check

> AgentShelf Holiday Check is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Checks whether a given YYYY-MM-DD date is a public holiday in a supported country and returns the English holiday name

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/holiday-check?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentshelf-holiday-check-396034ab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0hjcG3CvB_7NX3T8SifKe

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 agentshelf-holiday-check-396034ab -d '<json body>'
```

Example prompt: Is December 25, 2026 a public holiday in the US, and if so what's it called?

## When to prefer this

Use this endpoint when you need a fast, offline, deterministic lookup of national public holidays for a specific date and country from a well-defined set (US, CA, GB, IE, DE, FR, IT, CH, AT, BE, NL, LU, ES, PT, PL, SE, NO, DK, FI, AU, NZ). Prefer it over scraping or LLM reasoning for compliance-sensitive scheduling where accuracy and consistency matter. Not suitable for regional/state-level holidays or countries outside the supported list.

## Known failure modes

- Unknown country code — returns an error if the ISO 3166-1 alpha-2 code is not in the supported list
- Date out of range — years before 1970 or after 2100 are rejected
- Malformed date — dates not matching YYYY-MM-DD pattern are rejected
- Regional/state holidays not covered — only national public holidays are included
- Payment failure — $0.003 USDC on Base must be paid; unpaid requests can use the /v1/sandbox/holiday-check endpoint

## How this service works

Call when an agent needs whether a YYYY-MM-DD date is a public holiday, plus the English name. Send date and country (ISO 3166-1 alpha-2). Covers US, CA, GB, IE, and much of Europe plus AU and NZ. Unknown countries error. No network. Send JSON {"date":"2026-12-25","country":"US"}. Exact $0.003 USDC on Base. Try unpaid POST /v1/sandbox/holiday-check first.

## Output

Returns a JSON object indicating whether the given date is a public holiday in the specified country, along with the English name of the holiday (if applicable) and the calendar identifier used. Returns an error for unsupported country codes or dates outside the 1970–2100 range.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date": {
   "type": "string",
   "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
   "examples": [
    "2026-12-25"
   ],
   "description": "Calendar date in YYYY-MM-DD. Example: 2026-12-25. Interpreted as a civil date, not a timestamp. Returns holiday and English names. Years outside 1970-2100 are rejected."
  },
  "country": {
   "type": "string",
   "examples": [
    "US"
   ],
   "maxLength": 2,
   "minLength": 2,
   "description": "ISO 3166-1 alpha-2 country. Example: US. Bundled calendars: US, CA, GB, IE, DE, FR, IT, CH, AT, BE, NL, LU, ES, PT, PL, SE, NO, DK, FI, AU, NZ. Unknown codes error. National days only; regional holidays are omitted. The calendar field names the set."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentshelf-holiday-check-396034ab/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshelf.syntexa.ch](https://www.zero.xyz/host/agentshelf.syntexa.ch/llms.txt)