# Spain Holidays Lookup

> Spain Holidays Lookup is a paid API for AI agents from spain-agent-toolkit.spain-agent-toolkit.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-29).

Returns official Spanish public holidays for a given year, optionally filtered by autonomous community region.

## Facts

- Endpoint: GET https://spain-agent-toolkit.spain-agent-toolkit.workers.dev/v1/es/holidays?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/spain-holidays-lookup-453fe1e7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RVmBGGmHImFx0kzDi5TC3

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 spain-holidays-lookup-453fe1e7
```

Example prompt: What are the public holidays in the Community of Madrid (ES-MD) for 2027? I need a list with dates and names.

## When to prefer this

Choose this endpoint when you need structured, machine-readable Spanish public holiday data for a specific year and optionally a specific autonomous community, without needing to scrape government websites or maintain your own calendar. It is ideal for agents building travel itineraries, HR tools, scheduling systems, or delivery logistics that must respect Spanish festivos. It requires no API key or account — just a micropayment via x402/USDC.

## Known failure modes

- Missing required 'year' parameter returns a validation error
- Invalid or unsupported region code returns an error or empty result
- Payment failure via x402 (insufficient USDC) results in a 402 response and no data
- Year outside supported range may return an empty holidays array
- Network timeout from the Cloudflare Worker edge environment

## How this service works

Pay-per-call Spain utilities for AI agents over x402 (USDC). No accounts, no API keys. Public open data and offline computation only; nothing is stored.

## Output

A JSON object containing the queried year, the region code (if specified), and an array of holiday objects each with a date (YYYY-MM-DD), an English name, and a local Spanish name (localName).

## 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": [
      "year"
     ],
     "properties": {
      "year": {
       "type": "integer",
       "description": "Year, e.g. 2027"
      },
      "region": {
       "type": "string",
       "description": "Optional ISO 3166-2 region code: ES-AN,ES-AR,ES-AS,ES-CB,ES-CE,ES-CL,ES-CM,ES-CN,ES-CT,ES-EX,ES-GA,ES-IB,ES-MC,ES-MD,ES-ML,ES-NC,ES-PV,ES-RI,ES-VC"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "year": 2027,
  "region": "ES-MD",
  "holidays": [
   {
    "date": "2027-01-01",
    "name": "New Year's Day",
    "localName": "Año Nuevo"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/spain-holidays-lookup-453fe1e7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from spain-agent-toolkit.spain-agent-toolkit.workers.dev](https://www.zero.xyz/host/spain-agent-toolkit.spain-agent-toolkit.workers.dev/llms.txt)