{"uid":"cap_bPEWY1LCwQAShAqEtZ6x5","slug":"market-and-holiday-calendar-is-holiday-checker-6fd70c4d","name":"Market and Holiday Calendar – Is Holiday Checker","description":"Is a date a public holiday in a country? Also whether it is a business day and the next holiday after it.","url":"https://market-calendar.x402tookit.com/is-holiday?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","date"],"properties":{"date":{"type":"string","description":"Date YYYY-MM-DD"},"country":{"type":"string","description":"2-letter country code"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"date":{"type":["null","string"]},"source":{"type":["null","string"]},"country":{"type":["null","string"]},"reasons":{"type":["array","null"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"holidays":{"type":["array","null"],"items":{"type":"object","properties":{"name":{"type":["null","string"]},"regions":{},"localName":{"type":["null","string"]},"nationwide":{"type":["boolean","null"]}}}},"isWeekend":{"type":["boolean","null"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"nextHoliday":{},"isBusinessDay":{"type":["boolean","null"]},"isPublicHoliday":{"type":["boolean","null"]},"isRegionalHoliday":{"type":["boolean","null"]}}}}}}},"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_wd8ZTGWPVCpAFmI17YI_i","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":"Checks whether a given date is a public holiday, weekend, or business day in a specified country, and returns the next upcoming holiday after that date.","exampleAgentPrompt":"Is July 4th 2025 a public holiday in the US, and if so, is it a business day? Also tell me what the next holiday after that date is.","exampleUseCases":[{"title":"Scheduling meeting across borders","prompt":"Before I schedule a client call for November 11, 2025 with our French partners, can you check if that date is a public holiday in France and whether it's a business day?"},{"title":"E-commerce delivery date planning","prompt":"We're planning to ship orders to customers in Canada on February 17, 2025 — is that a public holiday there, or is it a normal business day?"},{"title":"Payroll processing date check","prompt":"Is October 13, 2025 a business day in the US? I need to know if we can process payroll that day or if it falls on a public holiday."}],"resultDescription":"Returns a structured response indicating whether the queried date is a public holiday, a regional holiday, a weekend, and/or a business day in the given country. Includes the holiday name(s), local name(s), affected regions, a plain-language summary and verdict, and the next upcoming holiday after the queried date. May also include a data source URL and degraded-mode flag.","failureModes":["Missing required query parameters (country or date) returns an error","Invalid date format (not YYYY-MM-DD) causes a parse error","Unsupported country code returns no holiday data or an error","Degraded mode flag set true if holiday data source is partially unavailable","Regional holidays may not be flagged for all sub-regions of a country"],"whenToPreferThis":"Choose this endpoint when you need to check a specific date for a specific country to determine holiday and business day status in a single call, especially when you also need to know the next upcoming holiday. Prefer this over the 'public holidays for a year' endpoint when checking a single date rather than browsing a full calendar. Ideal for scheduling, logistics, payroll, and compliance workflows where a single date decision must be validated quickly.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:12:39.056Z","isFirstParty":false,"canonicalSlug":"market-and-holiday-calendar-is-holiday-checker-6fd70c4d"}