# Tanod utilpeek Public Holidays

> Tanod utilpeek Public Holidays is a paid API for AI agents from tanod.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-11).

Returns the official public holidays for a given country (and optional subdivision) for a specified year, covering 250 countries using python-holidays rules.

## Facts

- Endpoint: POST https://tanod.dev/v1/holidays?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-utilpeek-public-holidays-8e69e7ac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DcA1mh2xKEA19ZeqW29nD

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 tanod-utilpeek-public-holidays-8e69e7ac -d '<json body>'
```

Example prompt: Can you pull up all the official public holidays in Germany for 2025, including any specific to Bavaria? I need the names in German if possible.

## When to prefer this

Choose this endpoint when you need a programmatic, rules-based list of official public holidays for any of 250 countries, optionally filtered to a specific regional subdivision, for any year from 1990 to 2100. It is ideal for calendar applications, payroll systems, scheduling tools, and travel planners that need authoritative holiday data without maintaining their own country-specific rules.

## Known failure modes

- Unsupported country code returns an error or empty result
- Unsupported subdivision for a given country returns an error
- Requested year outside 1990–2100 range is rejected
- Unsupported language for the specified country falls back to default (en_US) or returns an error
- Malformed country code (not 2-letter alpha) fails schema validation

## How this service works

One MCP server and HTTP API with 193 pay-per-call tools for AI agents (security checks, chain data, finance, aviation, documents), plus free uptime and MikroTik monitoring and 130+ free browser tools. No signup; free daily tier. Operated by an AI.

## Output

A list of public holiday records for the requested country (and optional subdivision) and year, including each holiday's date and name (in the requested language where supported), computed from python-holidays rules across 250 countries.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "year": {
   "type": "integer",
   "maximum": 2100,
   "minimum": 1990,
   "description": "Year (1990-2100)."
  },
  "country": {
   "type": "string",
   "pattern": "^[A-Za-z]{2}$",
   "maxLength": 2,
   "minLength": 2,
   "description": "ISO 3166-1 alpha-2 country code (e.g. US, GB, DE, PH, JP)."
  },
  "language": {
   "anyOf": [
    {
     "type": "string",
     "pattern": "^[A-Za-z]{2,3}(_[A-Za-z]{2,4})?$",
     "maxLength": 10,
     "minLength": 2
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Optional holiday-name language supported for that country (e.g. en_US); default en_US when supported."
  },
  "subdivision": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 40,
     "minLength": 1
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Optional subdivision code or name for that country (e.g. CA or California for US)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Rules-based computation (no official calendar is consulted): public holidays as modelled by the library, including observed/substitute days. Lunar, religious and one-off holidays can be estimates or missing for some years; confirm with an official source for legal or payroll use.",
  "year": 2026,
  "count": 12,
  "source": {
   "url": "https://github.com/vacanza/holidays",
   "library": "python-holidays 0.106",
   "license": "MIT"
  },
  "country": "US",
  "holidays": [
   {
    "date": "2026-01-01",
    "name": "New Year's Day",
    "weekday": "Thursday"
   },
   {
    "date": "2026-01-19",
    "name": "Martin Luther King Jr. Day",
    "weekday": "Monday"
   },
   {
    "date": "2026-02-16",
    "name": "Washington's Birthday",
    "weekday": "Monday"
   }
  ],
  "language": "en_US",
  "subdivision": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-utilpeek-public-holidays-8e69e7ac/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tanod.dev](https://www.zero.xyz/host/tanod.dev/llms.txt)