{"uid":"cap_YME6zDml66QPCFxZmKQ7X","slug":"public-holidays-lookup-api-f9ca71ab","name":"Public Holidays Lookup API","description":"Public data and utility APIs paid per call in USDC on Base (x402). No accounts, no API keys. 174 routes: crypto/equity data, onchain reads, DNS/email/security intel, geo/weather, x402 payment diagnostics, dev utilities and more.","url":"https://anibalb.duckdns.org/x402/public-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","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"year":2026,"total":11,"country":"US","holidays":[{"date":"2026-01-01","name":"New Year's Day","types":["Public","Bank"],"localName":"New Year's Day"}]}},"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_DCtA6JA_-S5Lk91GCBrgd","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 the list of public holidays for a given country and year, including holiday names, dates, and types","exampleAgentPrompt":"Can you get me the full list of public holidays in the US for 2026, including their names and dates?","exampleUseCases":[{"title":"Payroll compliance calendar check","prompt":"List all public and bank holidays in the United States for 2025 so I can make sure our payroll dates don't fall on a holiday."},{"title":"Travel planning around holidays","prompt":"What are all the national public holidays in Japan for 2026? I want to plan around them when booking my trip."},{"title":"Automated scheduling for business ops","prompt":"Fetch the public holidays for Canada in 2025 so our scheduling system can automatically block those days off for our team."}],"resultDescription":"A JSON object containing the year, country code, total number of holidays, and an array of holiday objects each with date (ISO 8601), name, localName, and types (e.g. Public, Bank).","failureModes":["Invalid or unsupported country code returns an error or empty holidays array","Payment failure via x402 protocol results in 402 status without data","Unsupported year outside the available data range may return empty results","Network timeout to the duckdns host due to infrastructure reliability of a personal/hobbyist server"],"whenToPreferThis":"Choose this endpoint when you need a quick, no-account, pay-per-call lookup of public holidays by country and year, especially in agentic workflows where you want to avoid API key management and pay fractions of a cent per call via USDC on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:45.361Z","isFirstParty":false,"canonicalSlug":"public-holidays-lookup-api-f9ca71ab"}