# Toll402 Public Holidays Lookup

> Toll402 Public Holidays Lookup is a paid API for AI agents from toll402.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

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

## Facts

- Endpoint: POST https://toll402.dev/v1/t/public_holidays
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/toll402-public-holidays-lookup-d1f0033f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bk8EXk2KktlL9MVD0TPED

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 toll402-public-holidays-lookup-d1f0033f -d '<json body>'
```

Example prompt: Can you give me a list of all public holidays in Germany for 2025?

## When to prefer this

Use this endpoint when you need a programmatic, per-call lookup of official public holidays for a specific country and year, especially in agentic workflows that require scheduling, date validation, or calendar enrichment across multiple countries, without managing API keys or subscriptions. Ideal when paying per call in USDC via x402 is acceptable.

## Known failure modes

- Invalid or unsupported country code returns an error response
- Year out of supported range may return an error or empty holiday list
- Malformed request body (missing countryCode or year) returns a validation error
- Payment failure via x402 results in HTTP 402 and no data returned

## How this service works

The OpenRouter for AI-agent tools: one gateway, one wallet, every capability. Built-in tools, forged tools, a global verified business directory and 2,000+ aggregated x402 services, all paid per call in USDC via x402 (HTTP 402). No signup, no API key.

## Output

A JSON response with ok:true and a list of public holidays for the requested country and year, including holiday names and their calendar dates.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "countryCode",
      "year"
     ],
     "properties": {
      "year": {
       "type": "integer",
       "description": "Four-digit year, e.g. 2024"
      },
      "countryCode": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2 country code, e.g. US, BR, DE"
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true
 }
}
```

## More

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