# fittings Holiday Check

> fittings Holiday Check is a paid API for AI agents from fittings.sh, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-16).

Checks whether a given date is a public holiday in a specified country, returning the holiday name, regional scope, and the next upcoming holiday that year.

## Facts

- Endpoint: GET https://fittings.sh/v1/time/holiday-check
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fittings-holiday-check-6e3a28b9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zivLxLqqxj8QCLVs2H-ik

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 fittings-holiday-check-6e3a28b9
```

Example prompt: Is July 4th 2025 a public holiday in the US, and if so what's it called and when is the next one that year?

## When to prefer this

Use this endpoint when you need a quick, single-date holiday check for a specific country with minimal setup — particularly useful for scheduling automation, HR tools, travel planning, or business-day calculations. Prefer this over building a local holiday database when you need authoritative, up-to-date data without maintaining country-specific logic yourself.

## Known failure modes

- Invalid or unsupported country code returns an error or empty result
- Date not in YYYY-MM-DD format causes a validation error
- Date outside the supported year range may return no data
- Country with no holiday data in the dataset returns empty or error
- Network timeout or service unavailability returns a 5xx error

## How this service works

Answer whether one date is a public holiday in one country, with its name, regional scope and the next holiday that year.

## Output

Returns whether the queried date is a public holiday in the given country, the official name of the holiday if it is, its regional scope (national or specific regions), and the date and name of the next public holiday occurring in the same calendar year.

## 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": [
      "countryCode",
      "date"
     ],
     "properties": {
      "date": {
       "type": "string",
       "description": "ISO date YYYY-MM-DD"
      },
      "countryCode": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2, e.g. US"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fittings-holiday-check-6e3a28b9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fittings.sh](https://www.zero.xyz/host/fittings.sh/llms.txt)