# fittings Public Holidays API

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

Returns every public holiday for a given country and year, including local names, English names, and observance scope.

## Facts

- Endpoint: GET https://fittings.sh/v1/time/public-holidays
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fittings-public-holidays-api-472da13f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ATE_2HdDC6CMsBXSBFGy3

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-public-holidays-api-472da13f
```

Example prompt: Can you get me all the public holidays in Germany for 2025, with both the German and English names?

## When to prefer this

Choose this endpoint when you need a complete, authoritative list of public holidays for a specific country and year, especially when you need both local-language names and English translations along with observance scope. Prefer it over generic calendar APIs when multi-country support with standardized ISO country codes and English name mapping is required.

## Known failure modes

- Invalid or unsupported ISO 3166-1 alpha-2 country code returns an error
- Year out of supported range returns an error or empty result
- Missing required query parameters (countryCode or year) returns a validation error
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Every public holiday for a country and year, with local and English names and observance scope.

## Output

A structured list of all public holidays for the requested country and year, each entry including the holiday date, its name in the local language, its English name, and the scope of observance (e.g. national, regional).

## 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",
      "year"
     ],
     "properties": {
      "year": {
       "type": "number"
      },
      "countryCode": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2, e.g. GB"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fittings-public-holidays-api-472da13f/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)