{"uid":"cap_45HzR9mVHtEL1uFBr-Edv","slug":"holiday-calendar-api-single-date-holiday-check-656e6560","name":"Holiday Calendar API – Single Date Holiday Check","description":"Holiday date check by country or subdivision — determine whether one ISO date is an official public holiday.","url":"https://holidays.use.x402atlas.com/check","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","format":"date","description":"ISO calendar date"},"country":{"enum":["AD","AL","AT","BE","BG","BR","BY","CH","CZ","DE","EE","ES","FR","HR","HU","IE","IT","LI","LT","LU","LV","MC","MD","MT","MX","NL","PL","PT","RO","RS","SE","SI","SK","SM","VA","ZA"],"type":"string","description":"Supported ISO 3166-1 alpha-2 country code: AD Andorra; AL Albania; AT Austria; BE Belgium; BG Bulgaria; BR Brazil; BY Belarus; CH Switzerland; CZ Czechia; DE Germany; EE Estonia; ES Spain; FR France; HR Croatia; HU Hungary; IE Ireland; IT Italy; LI Liechtenstein; LT Lithuania; LU Luxembourg; LV Latvia; MC Monaco; MD Moldova; MT Malta; MX Mexico; NL Netherlands; PL Poland; PT Portugal; RO Romania; RS Serbia; SE Sweden; SI Slovenia; SK Slovakia; SM San Marino; VA Vatican City; ZA South Africa."},"language":{"type":"string","pattern":"^[A-Z]{2}$","description":"Optional two-letter ISO 639-1 result language. Defaults to English when available."},"subdivision":{"type":"string","pattern":"^[A-Z]{2}-.+$","maxLength":20,"description":"Optional regional subdivision code beginning with the selected country code, for example DE-BE."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["country","date","is_holiday","holidays","queried_at"],"properties":{"date":{"type":"string","format":"date"},"country":{"type":"string"},"holidays":{"type":"array","items":{"type":"object","required":["name","start_date","end_date","type","nationwide","subdivisions"],"properties":{"name":{"type":"string","description":"Holiday name in the requested language when available"},"type":{"enum":["Public","Bank","Optional","School","BackToSchool","EndOfLessons"],"type":"string"},"end_date":{"type":"string","format":"date"},"nationwide":{"type":"boolean"},"start_date":{"type":"string","format":"date"},"subdivisions":{"type":"array","items":{"type":"string"}},"regional_scope":{"enum":["National","Regional","Local"],"type":"string"},"temporal_scope":{"enum":["FullDay","HalfDay"],"type":"string"}}}},"language":{"type":"string"},"is_holiday":{"type":"boolean"},"queried_at":{"type":"string","format":"date-time"},"subdivision":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"date":"2026-01-01","country":"DE","holidays":[{"name":"New Year's Day","type":"Public","end_date":"2026-01-01","nationwide":true,"start_date":"2026-01-01","subdivisions":[],"regional_scope":"National","temporal_scope":"FullDay"}],"language":"EN","is_holiday":true,"queried_at":"2026-07-27T12:00:00Z","subdivision":"DE-BE"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iaQHEmB3SERjbuGdG85uh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a specific ISO date is a public holiday in a given country or regional subdivision, returning holiday details.","exampleAgentPrompt":"Is December 26th 2025 an official public holiday in Germany, specifically in Bavaria (DE-BY)?","exampleUseCases":[{"title":"Payroll processing date validation","prompt":"Before we process payroll for next Friday November 1st 2024, can you confirm whether that date is a public holiday in France? I need to know if we should shift the payment date."},{"title":"E-commerce delivery scheduling","prompt":"We're planning to deliver orders on April 18th 2025 in Italy — is that day an official public holiday so I know whether courier services will be running?"},{"title":"Automated contract deadline checker","prompt":"My contract deadline falls on May 1st 2025 in Poland. Can you check if that's a public holiday so our legal team knows whether the deadline shifts?"}],"resultDescription":"Returns a JSON object with the queried country, date, a boolean is_holiday flag, and an array of matching holiday objects. Each holiday includes its name (optionally localized), type (e.g. public, bank), start and end dates, whether it is nationwide, and which subdivisions observe it.","failureModes":["Unsupported country code returns an error — only 37 specific ISO 3166-1 alpha-2 codes are accepted","Invalid date format returns a validation error — must be ISO 8601 YYYY-MM-DD","Invalid subdivision code (not matching the selected country prefix) returns an error","Payment failure or insufficient USDC balance results in a 402 Payment Required response","Subdivision not found for the given country returns an empty or error response"],"whenToPreferThis":"Use this endpoint when you need a single yes/no answer about whether one specific date is a public holiday in a supported country or subdivision. It is ideal for real-time checks during scheduling, payroll, compliance validation, or delivery planning workflows. Prefer it over the full-year listing endpoint when you only need to check one date and want minimal latency and cost. It supports regional subdivisions, making it more precise than country-level-only checkers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:38:05.497Z","isFirstParty":false}