# AgentTools Public Holidays Lookup

> AgentTools Public Holidays Lookup is a paid API for AI agents from agentstoolshub.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-12).

Returns upcoming or full-year public holidays for any of ~110 covered countries, including holiday names, dates, and nationwide status.

## Facts

- Endpoint: GET https://agentstoolshub.com/api/v1/live/holidays?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttools-public-holidays-lookup-d8fda987
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OS7mFLA8FVGSVbHJCM5Yb

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 agenttools-public-holidays-lookup-d8fda987
```

Example prompt: What are the upcoming public holidays in Germany? Show me the next 5 nationwide ones.

## When to prefer this

Choose this endpoint when an agent needs structured, machine-readable public holiday data for scheduling, planning, or calendar enrichment across a broad set of countries. It is ideal for scheduling agents, HR tools, travel planners, or any workflow that needs to avoid or account for public holidays. Prefer it over scraping government websites or relying on LLM knowledge, which may be outdated or hallucinated.

## Known failure modes

- Unsupported country code returns an error or empty list — only ~110 countries are covered by Nager.Date
- Missing required 'country' query parameter results in a 400-level error
- Invalid ISO-2 country code returns no results or an error
- Year out of supported range may return empty or error
- Network or upstream Nager.Date service outage causes 5xx response

## How this service works

List upcoming or full-year public holidays for any covered country via Nager.Date — names, dates and whether they're nationwide. Essential for scheduling agents. Use this when an agent needs to upcoming public holidays for ~110 countries.

## Output

Returns a list of public holiday objects for the specified country, each containing the holiday date, name, and whether it is a nationwide (country-wide) or regional holiday. For 'next' mode, returns the upcoming N holidays from today; for 'year' mode, returns all holidays in the specified calendar year.

## 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": {
      "op": {
       "enum": [
        "next",
        "year"
       ],
       "type": "string",
       "description": "Query"
      },
      "year": {
       "type": "number",
       "description": "Year (for full-year list)"
      },
      "count": {
       "type": "number",
       "description": "Max results"
      },
      "country": {
       "type": "string",
       "description": "Country (ISO-2)"
      }
     }
    }
   },
   "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/agenttools-public-holidays-lookup-d8fda987/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentstoolshub.com](https://www.zero.xyz/host/agentstoolshub.com/llms.txt)