# Holiday Calendar API – Public Holidays by Country and Year

> Holiday Calendar API – Public Holidays by Country and Year is a paid API for AI agents from api.strale.io, paid per call via x402, $0.0216/call, status unknown (last checked 2026-10-09).

Returns public holidays for a given country and year, including holiday names, dates, types, and fixed vs. variable status, covering 100+ countries.

## Facts

- Endpoint: GET https://api.strale.io/x402/holiday-calendar?utm_source=zero.xyz
- Price: $0.0216/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-strale-io-ddb2a7ec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3YjvttEQyThg9x12gVFQX

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 api-strale-io-ddb2a7ec
```

Example prompt: Can you get me the full list of public holidays in France for 2025, including whether each one is fixed or variable and what type it is?

## When to prefer this

Use this endpoint when you need structured, machine-readable public holiday data for scheduling, compliance, date calculations, or calendar enrichment for any of 100+ supported countries. Prefer this over general web search when you need typed metadata (public vs bank vs optional, fixed vs variable) rather than plain text.

## Known failure modes

- Missing or invalid country_code returns an error (must be valid ISO 2-letter code)
- Unsupported country code returns empty or error response
- Invalid year value may return an error or fallback to current year
- Network or payment (x402) failure prevents response

## How this service works

Get public holidays by country and year for the 200+ countries covered by Nager.Date. Returns holiday names, dates, types (public/bank/optional), and whether they are fixed or variable.

## Output

A list of holidays for the requested country and year, each entry containing the holiday name, date, type (public, bank, or optional), and whether the holiday falls on a fixed date or varies each year.

## Example request

```json
{
 "year": 2025,
 "country_code": "FR"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "country_code"
 ],
 "properties": {
  "year": {
   "type": "integer",
   "description": "Year (default current year)"
  },
  "country_code": {
   "type": "string",
   "description": "ISO 2-letter country code"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "year": {
  "type": "integer"
 },
 "holidays": {
  "type": "array"
 },
 "country_code": {
  "type": "string"
 },
 "total_holidays": {
  "type": "integer"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-strale-io-ddb2a7ec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.strale.io](https://www.zero.xyz/host/api.strale.io/llms.txt)