{"uid":"cap_JXqxRqZdi2DjlQUo9gzc1","slug":"x402-utils-country-holidays-lookup-461e387b","name":"x402 Utils – Country Holidays Lookup","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://qcb7fnxsbd7fbhj4.68r.lambda-web.us-east-1.on.aws/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":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_b4KGWpXkWUheQ_OqQ_Hkz","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 public, bank, school, optional, and observance holidays for a given country (and optionally a state/region) in a specified year, sourced from the date-holidays dataset covering ~200 countries.","exampleAgentPrompt":"What are all the public and bank holidays in Germany for 2025? Please include their names and types, and show the names in English.","exampleUseCases":[{"title":"Travel itinerary holiday awareness","prompt":"I'm planning a trip to Japan in April 2025 — can you pull up all the public holidays there so I know which days might be crowded or have closures?"},{"title":"Payroll calendar for US state","prompt":"I need to build our payroll schedule for California in 2025. Can you get me all the official holidays for the US, specifically for CA, so we know which days to skip?"},{"title":"International team scheduling","prompt":"Our team has members in France and the UK. Can you list all the holidays in both countries for 2026 in English so we can plan around them?"}],"resultDescription":"A JSON object containing the queried year, country, and a list of holidays each with their date, localized name, and type classification (public, bank, school, optional, or observance). Also includes a count of public holidays.","failureModes":["Invalid or unsupported country code returns an error or empty holiday list","Year outside 1970-2100 range returns a validation error","Unsupported state/region code for a country may return no region-specific holidays","Unsupported language code may fall back to default language or return an error","Network or Lambda cold-start timeout on rare occasions"],"whenToPreferThis":"Choose this endpoint when you need structured, typed holiday data (public vs bank vs school vs observance) for a wide range of countries (~200) and optionally specific states or regions, without building or maintaining your own holiday database. It's especially useful for calendar generation, payroll scheduling, travel planning, or compliance checks where holiday type classification matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:33:30.464Z","isFirstParty":false,"canonicalSlug":"x402-utils-country-holidays-lookup-461e387b"}