{"uid":"cap_0hjcG3CvB_7NX3T8SifKe","slug":"agentshelf-holiday-check-396034ab","name":"AgentShelf Holiday Check","description":"Call when an agent needs whether a YYYY-MM-DD date is a public holiday, plus the English name. Send date and country (ISO 3166-1 alpha-2). Covers US, CA, GB, IE, and much of Europe plus AU and NZ. Unknown countries error. No network. Send JSON {\"date\":\"2026-12-25\",\"country\":\"US\"}. Exact $0.003 USDC on Base. Try unpaid POST /v1/sandbox/holiday-check first.","url":"https://agentshelf.syntexa.ch/v1/holiday-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","examples":["2026-12-25"],"description":"Calendar date in YYYY-MM-DD. Example: 2026-12-25. Interpreted as a civil date, not a timestamp. Returns holiday and English names. Years outside 1970-2100 are rejected."},"country":{"type":"string","examples":["US"],"maxLength":2,"minLength":2,"description":"ISO 3166-1 alpha-2 country. Example: US. Bundled calendars: US, CA, GB, IE, DE, FR, IT, CH, AT, BE, NL, LU, ES, PT, PL, SE, NO, DK, FI, AU, NZ. Unknown codes error. National days only; regional holidays are omitted. The calendar field names the set."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LDkcwAokEEABDqyv12___","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","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 YYYY-MM-DD date is a public holiday in a supported country and returns the English holiday name","exampleAgentPrompt":"Is December 25, 2026 a public holiday in the US, and if so what's it called?","exampleUseCases":[{"title":"Skip business days on holidays","prompt":"Is April 18, 2025 a public holiday in the UK? I need to know if we should skip processing payments that day."},{"title":"Payroll calendar validation","prompt":"Check if May 1, 2026 is a national holiday in France — I'm building our payroll calendar and need to flag non-working days."},{"title":"International meeting scheduler","prompt":"Can you tell me whether October 3, 2025 is a public holiday in Germany? I'm scheduling a team call and don't want to book on a national day off."}],"resultDescription":"Returns a JSON object indicating whether the given date is a public holiday in the specified country, along with the English name of the holiday (if applicable) and the calendar identifier used. Returns an error for unsupported country codes or dates outside the 1970–2100 range.","failureModes":["Unknown country code — returns an error if the ISO 3166-1 alpha-2 code is not in the supported list","Date out of range — years before 1970 or after 2100 are rejected","Malformed date — dates not matching YYYY-MM-DD pattern are rejected","Regional/state holidays not covered — only national public holidays are included","Payment failure — $0.003 USDC on Base must be paid; unpaid requests can use the /v1/sandbox/holiday-check endpoint"],"whenToPreferThis":"Use this endpoint when you need a fast, offline, deterministic lookup of national public holidays for a specific date and country from a well-defined set (US, CA, GB, IE, DE, FR, IT, CH, AT, BE, NL, LU, ES, PT, PL, SE, NO, DK, FI, AU, NZ). Prefer it over scraping or LLM reasoning for compliance-sensitive scheduling where accuracy and consistency matter. Not suitable for regional/state-level holidays or countries outside the supported list.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:30:04.416Z","isFirstParty":false,"canonicalSlug":"agentshelf-holiday-check-396034ab"}