# x402 Utils – Country Holidays Lookup

> x402 Utils – Country Holidays Lookup is a paid API for AI agents from qcb7fnxsbd7fbhj4.68r.lambda-web.us-east-1.on.aws, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-29).

Returns public, bank, school, optional, and observance holidays for a given country (and optionally a state/region) in a specified year, sourced from the date-holidays dataset covering ~200 countries.

## Facts

- Endpoint: GET https://qcb7fnxsbd7fbhj4.68r.lambda-web.us-east-1.on.aws/v1/holidays?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-utils-country-holidays-lookup-461e387b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JXqxRqZdi2DjlQUo9gzc1

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 x402-utils-country-holidays-lookup-461e387b
```

Example prompt: What are all the public and bank holidays in Germany for 2025? Please include their names and types, and show the names in English.

## When to prefer this

Choose this endpoint when you need structured, typed holiday data (public vs bank vs school vs observance) for a wide range of countries (~200) and optionally specific states or regions, without building or maintaining your own holiday database. It's especially useful for calendar generation, payroll scheduling, travel planning, or compliance checks where holiday type classification matters.

## Known failure modes

- Invalid or unsupported country code returns an error or empty holiday list
- Year outside 1970-2100 range returns a validation error
- Unsupported state/region code for a country may return no region-specific holidays
- Unsupported language code may fall back to default language or return an error
- Network or Lambda cold-start timeout on rare occasions

## How this service works

Holidays of a country (and optionally a state or region) in a year, with date, name and type (public, bank, school, optional, observance), from the date-holidays data for about 200 countries.

## Output

A JSON object containing the queried year, country, and a list of holidays each with their date, localized name, and type classification (public, bank, school, optional, or observance). Also includes a count of public holidays.

## 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": {
      "lang": {
       "type": "string",
       "description": "language of the names, such as en or ja"
      },
      "year": {
       "type": "integer",
       "description": "the year (1970-2100), default this year"
      },
      "state": {
       "type": "string",
       "description": "state or region code, such as CA for the US"
      },
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2 code, such as JP, US, DE"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "year": {},
      "country": {},
      "holidays": {},
      "public_holidays": {}
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-utils-country-holidays-lookup-461e387b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from qcb7fnxsbd7fbhj4.68r.lambda-web.us-east-1.on.aws](https://www.zero.xyz/host/qcb7fnxsbd7fbhj4.68r.lambda-web.us-east-1.on.aws/llms.txt)