{"uid":"cap_aj_DJ20VsP53RW1ApnrgP","slug":"public-holidays-by-country-nager-date-d10d02e0","name":"Public Holidays by Country (Nager Date)","description":"51 REST endpoints for AI agents. Weather, news, crypto, stocks, products, courses, real estate, and 42 more. Pay per call in USDC/USDT via x402.","url":"https://engedi.digi-life17.workers.dev/api/holidays","method":"GET","headers":{},"bodySchema":null,"responseSchema":{},"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_5r3h7SRGjvkAG5LOuTX8g","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 a list of public holidays for a given country and year using the Nager Date dataset","exampleAgentPrompt":"What are all the public holidays in Germany for 2025?","exampleUseCases":null,"resultDescription":"A structured JSON object containing a list of public holidays for the specified country and year, including holiday names, dates, and metadata such as cache status, data source, confidence score, and last updated timestamp.","failureModes":["Missing or invalid country code returns an error — country is a required parameter","Invalid ISO 3166-1 alpha-2 code may return no results or an error","Year out of range may return empty data or an error from the upstream Nager Date source","Upstream Nager Date API unavailability may cause failures or stale cached data","Payment of 0.005 USDC required per call; unpaid requests will be rejected with 402"],"whenToPreferThis":"Use this endpoint when you need authoritative, structured public holiday data for a specific country and year. Ideal for scheduling apps, business logic that avoids holidays, HR tools, or any agent needing to know if a given date is a holiday in a particular country. Prefer this over manual web searches or scraping since it returns clean, machine-readable JSON directly from the Nager Date dataset.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:47:00.433Z","isFirstParty":false}