{"uid":"cap_bJl0XDaU3gBDbRL1yRzvg","slug":"quartermaster-surewhynot-app-v1-holiday-92259582","name":"quartermaster.surewhynot.app/v1/holiday","description":"Is a date a public holiday in a country (2-letter ISO code)? Returns the holiday name, its types, and the next upcoming holiday that year.","url":"https://quartermaster.surewhynot.app/v1/holiday","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":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD (defaults to today, UTC)"},"country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"2-letter ISO 3166 country code"}}}},"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_AKUDGfQ8QCl1ctgl-eHyj","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":"Checks whether a given date is a public holiday in a specified country and returns the holiday name, types, and next upcoming holiday that year.","exampleAgentPrompt":"Is July 4th 2025 a public holiday in the US? If so, what's the holiday name and type, and what's the next holiday coming up that year?","exampleUseCases":[{"title":"Scheduling team meetings across countries","prompt":"Before I book our quarterly all-hands meeting for December 26th, can you check if that's a public holiday in the UK, Canada, and Australia? I need to know if any of those countries have bank holidays that day so we don't conflict with time off."},{"title":"Automating payroll holiday compliance","prompt":"I'm setting up our payroll system for next year. Can you tell me if January 1st, 2025 is a national public holiday in Germany, and what the next public holiday after that is? We need to make sure we're flagging the right dates for extra compensation."},{"title":"Verifying client event availability","prompt":"Our client wants to schedule a product launch event on November 11th in France. Is that a public holiday there, and if it is, what type of holiday is it? We might need to reschedule if it conflicts with how people would be celebrating."}],"resultDescription":"Returns whether the queried date is a public holiday in the given country, including the holiday's name and category types (e.g. national, bank, observance), plus the next upcoming public holiday in that country for the same year.","failureModes":["Invalid or unsupported country code returns an error or empty result","Date format not matching YYYY-MM-DD pattern causes a validation error","Date outside supported range may return no data","Network or upstream data source unavailability causes a 5xx error","Payment failure (x402) prevents the request from being processed"],"whenToPreferThis":"Use this endpoint when you need a quick, low-latency point-in-time check on whether a specific date is a public holiday in a particular country, and want the holiday name and type alongside the next upcoming holiday. Prefer this over calendar scraping or general-purpose web search when you need structured, programmatic holiday data for scheduling, compliance, or workflow automation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:49:19.480Z","isFirstParty":false}