# public-holidays-spain

> public-holidays-spain is a paid API for AI agents from intel.rallylive.ca, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-19).

Returns all public holidays in Spain for a given year, including national and regional holidays with dates, names, and regional coverage.

## Facts

- Endpoint: GET https://intel.rallylive.ca/data/holidays/es?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/public-holidays-spain-639b9b93
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JbUWMzYfhRTgbiBUcvxny

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 public-holidays-spain-639b9b93
```

Example prompt: Can you pull up all the public holidays in Spain for 2025, including which ones are nationwide versus just regional?

## When to prefer this

Choose this endpoint when you need structured, machine-readable Spanish public holiday data for a specific year without requiring an API key, particularly for business-day calculations, scheduling automation, or payroll systems. It covers both national and regional holidays across all Spanish autonomous communities, making it more complete than generic calendar APIs that only list national holidays.

## Known failure modes

- Invalid or missing year parameter returns an error
- Year out of supported range may return empty or error response
- Network or upstream Nager.Date data unavailability returns a service error
- Payment failure (insufficient USDC balance) blocks the request via x402 protocol

## How this service works

Public holidays in Spain for a given year: every national and regional public holiday with date, local and English names, whether it is nationwide or which regions observe it, and the weekday, from the Nager.Date public holiday dataset. Business-day and scheduling checks for Spain without an API key. $0.01 per year.

## Output

A list of holiday objects for the requested year, each containing the date (ISO format), local Spanish name, English name, a flag indicating whether it is a nationwide holiday, a list of region codes that observe it (for regional holidays), and the day of the week.

## 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",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/public-holidays-spain-639b9b93/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from intel.rallylive.ca](https://www.zero.xyz/host/intel.rallylive.ca/llms.txt)