{"uid":"cap_QrhT4jtyuRdKcyC2Xrjl4","slug":"world-public-holidays-by-country-and-year-ce9ad737","name":"World Public Holidays by Country and Year","description":"Full list of official public holidays for one country and year, from the Nager.Date registry (100+ countries, legally accurate dates). Query: ?country=FR (ISO 3166-1 alpha-2, required) &year=2026 (1975-2077, defaults to current year). Returns date, English + local name, nationwide flag, regional counties and holiday types per entry. Cached 24h.","url":"https://x402-datashop-production.up.railway.app/v1/world/holidays","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"],"properties":{"year":{"type":"integer","description":"Year between 1975 and 2077 (default: current year)"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code, e.g. FR"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tWCwitH6ndShHGSBMY5dT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the full list of official public holidays for a given country and year, sourced from the Nager.Date registry with legally accurate dates for 100+ countries.","exampleAgentPrompt":"Can you get me the full list of official public holidays in France for 2026, including their local names and whether they apply nationwide?","exampleUseCases":null,"resultDescription":"An array of public holiday entries for the specified country and year, each containing the date, English name, local language name, a flag indicating if it is nationwide, applicable regional counties, and holiday type classification. Results are cached for 24 hours.","failureModes":["Missing or invalid country code returns an error (country parameter is required)","Year outside the supported range 1975–2077 returns an error","Unsupported or unrecognized country code may return an empty list or error","Network or upstream Nager.Date registry unavailability causes a service error"],"whenToPreferThis":"Use this endpoint when you need legally accurate, structured public holiday data for a specific country and year, especially when regional/county-level detail and local language names are needed. Prefer this over general web search for holiday data when machine-readable, structured output is required for scheduling, compliance, or calendar automation tasks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:49:22.167Z","isFirstParty":false}