{"uid":"cap_IgjPL-ZY24RJ5bTE6hqZC","slug":"signaldesk-ai-public-holidays-lookup-2c0c40f7","name":"SignalDesk AI Public Holidays Lookup","description":"Evidence-backed autonomous AI jobs and paid data tools. Queue/D1/cron run outside the chat; free quotas and bounded execution apply.","url":"https://x402-agent.kariguetoazul.workers.dev/api/data/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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["country","year"],"properties":{"year":{"type":"integer","maximum":2100,"minimum":1900,"description":"Year."},"country":{"type":"string","pattern":"^[A-Z]{2}$","maxLength":2,"description":"Two-letter country code."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"year":2026,"source":{"provider":"Nager.Date public holiday API","expires_at":"2026-10-03T09:44:50.016Z","fetched_at":"2026-10-02T09:44:50.016Z","source_url":"https://date.nager.at/api/v3/PublicHolidays/2026/PT","transformed":true},"country":"PT","holidays":[{"date":"2026-01-01","name":"New Year's Day","types":["Public"],"global":true,"counties":null,"local_name":"Ano Novo"},{"date":"2026-02-17","name":"Carnival","types":["Optional"],"global":true,"counties":null,"local_name":"Carnaval"},{"date":"2026-04-03","name":"Good Friday","types":["Public"],"global":true,"counties":null,"local_name":"Sexta-feira Santa"},{"date":"2026-04-05","name":"Easter Sunday","types":["Public"],"global":true,"counties":null,"local_name":"Domingo de Páscoa"},{"date":"2026-04-25","name":"Freedom Day","types":["Public"],"global":true,"counties":null,"local_name":"Dia da Liberdade"},{"date":"2026-05-01","name":"Labour Day","types":["Public"],"global":true,"counties":null,"local_name":"Dia do Trabalhador"},{"date":"2026-06-01","name":"Azores Day","types":["Public"],"global":false,"counties":["PT-20"],"local_name":"Dia dos Açores"},{"date":"2026-06-04","name":"Corpus Christi","types":["Public"],"global":true,"counties":null,"local_name":"Corpo de Deus"},{"date":"2026-06-10","name":"National Day","types":["Public"],"global":true,"counties":null,"local_name":"Dia de Portugal, de Camões e das Comunidades Portuguesas"},{"date":"2026-07-01","name":"Madeira Day","types":["Public"],"global":false,"counties":["PT-30"],"local_name":"Dia da Madeira"},{"date":"2026-08-15","name":"Assumption Day","types":["Public"],"global":true,"counties":null,"local_name":"Assunção de Nossa Senhora"},{"date":"2026-10-05","name":"Republic Day","types":["Public"],"global":true,"counties":null,"local_name":"Implantação da República"},{"date":"2026-11-01","name":"All Saints Day","types":["Public"],"global":true,"counties":null,"local_name":"Dia de Todos-os-Santos"},{"date":"2026-12-01","name":"Restoration of Independence","types":["Public"],"global":true,"counties":null,"local_name":"Restauração da Independência"},{"date":"2026-12-08","name":"Immaculate Conception","types":["Public"],"global":true,"counties":null,"local_name":"Imaculada Conceição"},{"date":"2026-12-25","name":"Christmas Day","types":["Public"],"global":true,"counties":null,"local_name":"Natal"},{"date":"2026-12-26","name":"St. Stephen's Day","types":["Public"],"global":false,"counties":["PT-30"],"local_name":"Primeira Oitava"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_x2GCGhGxRhWVoi8bjtirD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a list of public and optional holidays for a given country and year, sourced from the Nager.Date public holiday API.","exampleAgentPrompt":"Can you pull the full list of public holidays for Portugal in 2026, including any regional ones for places like the Azores or Madeira?","exampleUseCases":[{"title":"HR payroll calendar planning","prompt":"What are all the public holidays in Germany for 2025? I need to build out our payroll calendar and make sure we're accounting for every national and regional holiday."},{"title":"International project scheduling","prompt":"We're coordinating a project with teams in Japan and Brazil — can you get me the official public holidays for both countries in 2025 so I can block out the right days?"},{"title":"Travel itinerary awareness","prompt":"I'm planning a trip to Spain in the summer of 2026 — can you fetch the public holidays for that year so I know which days businesses might be closed?"}],"resultDescription":"A JSON object containing the year, country code, a source metadata block (provider name, source URL, fetch timestamp, cache expiry), and an array of holiday objects each with a date (YYYY-MM-DD), English name, local-language name, holiday types (e.g. Public, Optional), a global boolean indicating whether it applies nationwide, and an optional list of county/region codes where it applies.","failureModes":["Invalid or unsupported country code returns an error or empty holiday list","Year outside 1900–2100 range is rejected by schema validation","Upstream Nager.Date API unavailability may cause fetch failure or stale cached data","Missing required query parameters (country or year) results in a 400-level error","Non-GET HTTP methods are rejected"],"whenToPreferThis":"Choose this endpoint when you need structured, multi-field holiday data (dates, local names, types, regional scope) for a specific country and year, especially when you require both national and sub-national (county-level) holiday distinctions. Prefer this over generic web search when you need machine-readable, consistently formatted holiday lists suitable for calendar building, scheduling logic, or payroll systems.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:42:12.058Z","isFirstParty":false,"canonicalSlug":"signaldesk-ai-public-holidays-lookup-2c0c40f7"}