{"uid":"cap_0Nm9qC9-kpGIotPlbGp56","slug":"x402-utils-public-holidays-by-country-0a8439fb","name":"x402 Utils – Public Holidays by Country","description":"Holidays of a country (and optionally a state or region) in a year, with date, name and type (public, bank, school, optional, observance), from the date-holidays data for about 200 countries.","url":"https://utils.kagurazaka.dev/v1/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"],"properties":{"lang":{"type":"string","description":"language of the names, such as en or ja"},"year":{"type":"integer","description":"the year (1970-2100), default this year"},"state":{"type":"string","description":"state or region code, such as CA for the US"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 code, such as JP, US, DE"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"year":{},"country":{},"holidays":{},"public_holidays":{}}}}}}},"responseSchema":{"type":"json","example":{"year":2026,"country":"JP","holidays":[{"date":"2026-01-01","name":"New Year's Day","type":"public"}],"public_holidays":16}},"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_EmJpmG6ZQenH1eShU_oSy","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 all holidays for a given country (and optionally a state/region) in a specified year, including each holiday's date, name, and type (public, bank, school, optional, observance).","exampleAgentPrompt":"What are all the public holidays in Japan for 2026? Give me the date, name, and type for each one, in English.","exampleUseCases":[{"title":"HR payroll calendar setup","prompt":"Can you get me a list of all public and bank holidays in Germany for 2025, in English? I need the date, name, and type so I can configure our payroll system correctly."},{"title":"Travel itinerary around local holidays","prompt":"I'm planning a trip to Brazil in 2025 — can you pull up all the national holidays there so I know which days businesses might be closed?"},{"title":"App localization for regional holidays","prompt":"Give me all the holidays for California, US in 2026, including their types — public, optional, observance — so I can build them into our scheduling app."}],"resultDescription":"A JSON object containing the year, country code, a list of holidays (each with date in YYYY-MM-DD format, name in the requested language, and type such as public/bank/school/optional/observance), and a count of public holidays.","failureModes":["Missing or invalid country code returns an error — must be a valid ISO 3166-1 alpha-2 code","Invalid or out-of-range year (outside 1970–2100) returns an error","Invalid state/region code may return no state-specific holidays or an error","Unsupported language code may fall back to the default language","Payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need a structured, machine-readable list of holidays for any of ~200 countries, with optional filtering by state/region and language. It is ideal for calendar integrations, HR scheduling, travel planning, or any application that needs to programmatically reason about public, bank, school, or observance holidays. Prefer this over scraping government websites or hardcoding holiday lists.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:35:47.895Z","isFirstParty":false,"canonicalSlug":"x402-utils-public-holidays-by-country-0a8439fb"}