# holidays.openverbs.com – Check Public Holiday

> holidays.openverbs.com – Check Public Holiday 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).

Checks whether a specific date is a public holiday in a given country, optionally filtered by state/region, sub-region, holiday type, and language.

## Facts

- Endpoint: POST https://holidays.openverbs.com/v1/check
- 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/holidays-openverbs-com-check-public-holiday-943996f2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pQSCfcnN57gOcV68f5l3L

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 holidays-openverbs-com-check-public-holiday-943996f2 -d '<json body>'
```

Example prompt: Is December 26 a public holiday in Germany for Bavaria (state code BY)? Check for the date 2024-12-26.

## When to prefer this

Use this endpoint when you need a simple yes/no check for a single specific date in a country or state — for example, to validate a scheduled task, payroll date, or shipment date. Prefer this over the sibling list endpoint when you already have the specific date and don't need the full annual calendar.

## Known failure modes

- Invalid or unrecognized country code returns an error
- Date not in YYYY-MM-DD format is rejected by schema validation
- Unsupported state/region code for a country may return no result or an error
- Holiday type filter with no matching types returns a non-holiday result
- Network or service timeout if upstream holiday data provider is unavailable

## How this service works

Check whether a specific date is a public holiday in a country (optionally by state/region).

## Output

Returns a boolean or structured response indicating whether the specified date is a holiday in the given country (and optional state/region), along with the holiday name, type, and any relevant metadata such as localized name in the requested language.

## 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",
      "date"
     ],
     "properties": {
      "date": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
       "description": "Date to check (YYYY-MM-DD)."
      },
      "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/holidays-openverbs-com-check-public-holiday-943996f2/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)