# OpenVerbs Holidays List

> OpenVerbs Holidays List is a paid API for AI agents from holidays.openverbs.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns all holidays for a given country and calendar year, with optional filtering by state/region, language, and holiday type.

## Facts

- Endpoint: POST https://holidays.openverbs.com/v1/list
- 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/openverbs-holidays-list-803e90b3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MFM_UqFXx1i_STa1Xd5PR

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 openverbs-holidays-list-803e90b3 -d '<json body>'
```

Example prompt: Can you list all public and bank holidays in Germany for 2025, including any specific to Bavaria, in English?

## When to prefer this

Use this endpoint when you need a comprehensive list of holidays for a country over an entire calendar year, especially when filtering by state, region, type, or language is needed. Prefer this over the sibling 'check date' endpoint when you need to enumerate or display all holidays rather than verify a single date.

## Known failure modes

- Invalid or unsupported country code returns an error or empty list
- Year outside 1900–2200 range is rejected by schema validation
- Unsupported state or region code may return an error or be silently ignored
- Requested language may not be available for all holiday names, falling back to default
- Network or payment (x402) failure results in no response

## How this service works

List a country's holidays for a calendar year (optionally by state/region, language and type).

## Output

A structured list of holidays for the specified country and year, each entry including the holiday name (in the requested language), date, type (public, bank, school, optional, observance), and any applicable state or region scope.

## 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": [
      "country",
      "year"
     ],
     "properties": {
      "year": {
       "type": "integer",
       "maximum": 2200,
       "minimum": 1900,
       "description": "Calendar year."
      },
      "state": {
       "type": "string",
       "description": "Optional state/province code (e.g. \"CA\" for US-California, \"BY\" for DE-Bavaria)."
      },
      "types": {
       "type": "array",
       "items": {
        "enum": [
         "public",
         "bank",
         "school",
         "optional",
         "observance"
        ],
        "type": "string"
       },
       "description": "Optional filter: only these holiday types. Defaults to all."
      },
      "region": {
       "type": "string",
       "description": "Optional sub-region code, where the country/state defines one."
      },
      "country": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "ISO 3166-1 alpha-2 country code, e.g. \"US\", \"DE\", \"GB\"."
      },
      "language": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "Optional 2-letter language for holiday names (e.g. \"en\")."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/openverbs-holidays-list-803e90b3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from holidays.openverbs.com](https://www.zero.xyz/host/holidays.openverbs.com/llms.txt)