# agentshield.live Holiday Checker

> agentshield.live Holiday Checker is a paid API for AI agents from agentshield.live, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-22).

Returns whether a given date is a public holiday in a specified country, including the holiday name if applicable.

## Facts

- Endpoint: GET https://agentshield.live/holiday?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentshield-live-holiday-checker-a194bdda
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_W9ge9A_enZ2i5oolbA8l0

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 agentshield-live-holiday-checker-a194bdda
```

Example prompt: Is May 1st 2025 a public holiday in Germany? I need to know the holiday name if it is.

## When to prefer this

Use this endpoint when an agent needs a quick, structured yes/no answer about whether a specific calendar date is a national public holiday in a given country. It is ideal for scheduling, payroll, compliance, and logistics workflows that must respect country-specific non-working days. Prefer this over general calendar APIs when you need a machine-readable boolean response specifically about public holidays.

## Known failure modes

- Invalid or unsupported country code returns an error or empty result
- Malformed date (not YYYY-MM-DD) causes a validation error
- Country not covered by the dataset returns no data or an error
- Future dates beyond the data source's range may return uncertain results

## How this service works

Call when an agent needs to know whether a calendar date is a public holiday in a country. Returns yes or no and the holiday name.

## Output

Returns a boolean indicating whether the specified date is a public holiday in the given country, along with the name of the holiday if one exists. If it is not a holiday, returns a negative result with no holiday name.

## 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",
      "date"
     ],
     "properties": {
      "date": {
       "type": "string",
       "description": "YYYY-MM-DD."
      },
      "country": {
       "type": "string",
       "description": "Two-letter country code, such as DE."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentshield-live-holiday-checker-a194bdda/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshield.live](https://www.zero.xyz/host/agentshield.live/llms.txt)