{"uid":"cap_GZQHhovK-UKH6ufDKAOjt","slug":"market-and-holiday-calendar-public-holidays-by-country-and-year-e112f4bd","name":"Market and Holiday Calendar – Public Holidays by Country and Year","description":"Public holidays for a country and year (about 100 countries), flagging regional-only holidays and weekday of each.","url":"https://market-calendar.x402tookit.com/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"],"type":"string"},"queryParams":{"type":"object","required":["country","year"],"properties":{"year":{"type":"integer","description":"Year, 1990 to 2100"},"country":{"type":"string","description":"2-letter country code, e.g. US, GB, DE"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"year":{"type":["null","number"]},"count":{"type":["null","number"]},"source":{"type":["null","string"]},"country":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"holidays":{"type":["array","null"],"items":{"type":"object","properties":{"date":{"type":["null","string"]},"name":{"type":["null","string"]},"types":{"type":["array","null"],"items":{"type":"string"}},"regions":{"type":["array","null"],"items":{"type":"string"}},"weekday":{"type":["null","string"]},"localName":{"type":["null","string"]},"nationwide":{"type":["boolean","null"]}}}},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_d8gGE2_8jMiCP0BVFHnul","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all public holidays for a given country and year, including holiday names, dates, weekdays, regional scope, and holiday types.","exampleAgentPrompt":"Can you pull the full list of public holidays in Germany for 2025, including which ones are regional-only and what day of the week they fall on?","exampleUseCases":[{"title":"HR payroll compliance by country","prompt":"I need the complete list of public holidays in France for 2025 so I can set up our payroll calendar — include whether each holiday is nationwide or only applies to certain regions."},{"title":"Travel itinerary planning around closures","prompt":"What are all the public holidays in Japan in 2024? I want to know the exact dates, the day of the week they fall on, and their names so I can plan around potential shop and museum closures."},{"title":"Software release schedule de-risking","prompt":"List all public holidays in the United States for 2026, with the weekday each falls on and whether they're nationwide or regional — I need to avoid scheduling deployments on those days."}],"resultDescription":"A JSON object containing: a list of holiday entries each with date (YYYY-MM-DD), English name, local name, weekday name, array of holiday types, array of applicable regions, and a boolean indicating if it is nationwide. Also includes a count of holidays, the country code, year, data source name and URL, optional summary/verdict fields, and a degraded-mode flag if data quality is reduced.","failureModes":["Invalid or unsupported 2-letter country code returns an error or empty holiday list","Year outside the 1990–2100 range may return an error or no results","Some countries may have incomplete regional holiday data, flagged via the degraded boolean","Missing required query parameters (country or year) will result in a 400-level error","Data may reflect the source provider's last update and not real-time legislative changes"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, structured list of all public holidays for a country in a given year — especially when you need regional vs. nationwide distinction and weekday information. Prefer this over a single-date holiday lookup when you need the full annual calendar for scheduling, compliance, or planning workflows. Covers ~100 countries from 1990 to 2100.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:31:22.734Z","isFirstParty":false,"canonicalSlug":"market-and-holiday-calendar-public-holidays-by-country-and-year-e112f4bd"}