{"uid":"cap_RVmBGGmHImFx0kzDi5TC3","slug":"spain-holidays-lookup-453fe1e7","name":"Spain Holidays Lookup","description":"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.","url":"https://spain-agent-toolkit.spain-agent-toolkit.workers.dev/v1/es/holidays?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"type":"json","example":{"year":2027,"region":"ES-MD","holidays":[{"date":"2027-01-01","name":"New Year's Day","localName":"Año Nuevo"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_msIemsDVW_Yoazshydr_i","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns official Spanish public holidays for a given year, optionally filtered by autonomous community region.","exampleAgentPrompt":"What are the public holidays in the Community of Madrid (ES-MD) for 2027? I need a list with dates and names.","exampleUseCases":[{"title":"Travel itinerary date checking","prompt":"I'm planning a trip to Barcelona in April 2026 — can you tell me which days are public holidays in Catalonia (ES-CT) so I can avoid scheduling business meetings on those days?"},{"title":"HR payroll calendar for Spain","prompt":"I need all the official public holidays across Spain for 2025, including regional ones for the Basque Country (ES-PV), so I can build the payroll calendar for our office there."},{"title":"E-commerce delivery schedule planning","prompt":"Which days in November and December 2026 are public holidays in Andalusia (ES-AN)? I want to make sure we don't promise next-day delivery on those dates."}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:33:27.953Z","isFirstParty":false,"canonicalSlug":"spain-holidays-lookup-453fe1e7"}