{"uid":"cap_LlgGdztiR99J7fHCYdVxO","slug":"holiday-calendar-9a872c86","name":"Holiday Calendar","description":"List public holidays for country= + year= from Nager.Date (~110 countries). Marks national vs regional entries. Same source business-days uses — for agents that need the raw calendar.","url":"https://402.com.tr/api/x402/holiday-calendar","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"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["country"],"properties":{"year":{"type":"string","description":"Year"},"country":{"type":"string","description":"Country (ISO-2)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_GYMq0VMfhJdjlybaQC9SA","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, distinguishing national from regional entries, sourced from Nager.Date (~110 countries).","exampleAgentPrompt":"Can you pull up the full list of public holidays in Germany for 2025, including which ones are national versus regional?","exampleUseCases":[{"title":"Payroll scheduling across countries","prompt":"I need the complete list of public holidays in France for 2025 — both national and regional — so I can make sure we don't schedule payroll runs on those days."},{"title":"Travel itinerary around local holidays","prompt":"What are all the public holidays in Japan for 2024? I want to know which are national versus regional so I can plan around crowded periods."},{"title":"SLA calendar for support team","prompt":"Pull the official public holiday calendar for the United States for 2025 — I need to build out our support team's SLA schedule and mark which days to exclude."}],"resultDescription":"A list of public holiday entries for the requested country and year. Each entry includes the holiday date, name, and a flag indicating whether it is a national or regional/local holiday. Covers approximately 110 countries via the Nager.Date data source.","failureModes":["Unsupported country code returns an error or empty list — verify the ISO-2 code is among Nager.Date's ~110 supported countries","Invalid or out-of-range year may return an empty result or error","Missing required 'country' query parameter results in a 400-level error","Network or upstream Nager.Date availability issues may cause timeouts"],"whenToPreferThis":"Choose this endpoint when you need the raw public holiday calendar data for a specific country and year — for example, to build custom scheduling logic, render a calendar UI, or join holiday data with other datasets. If you simply need to add or count business days accounting for holidays, the sibling Business Days endpoint may be more convenient. Prefer this endpoint when you want full holiday list access rather than a derived business-day calculation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:50:52.085Z","isFirstParty":false}