{"slug":"holidays-use-x402atlas-com-check-a836d7","title":"Holiday date check by country or subdivision — determine whether one ISO date is","host":"holidays.use.x402atlas.com","method":"GET","resource":"https://holidays.use.x402atlas.com/check","category":"other","description":"Holiday date check by country or subdivision — determine whether one ISO date is an official public holiday.","price_listed":0.005,"price_asked":0.005,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":900,"reported_calls_30d":11,"reported_payers_30d":8,"networks":["eip155:137","eip155:42161","eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"country":"DE","date":"2026-01-01","language":"EN","subdivision":"DE-BE"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"queryParams":{"properties":{"country":{"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.","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"},"date":{"description":"ISO calendar date","format":"date","type":"string"},"language":{"description":"Optional two-letter ISO 639-1 result language. Defaults to English when available.","pattern":"^[A-Z]{2}$","type":"string"},"subdivision":{"description":"Optional regional subdivision code beginning with the selected country code, for example DE-BE.","maxLength":20,"pattern":"^[A-Z]{2}-.+$","type":"string"}},"required":["country","date"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"country":{"type":"string"},"date":{"format":"date","type":"string"},"holidays":{"items":{"properties":{"end_date":{"format":"date","type":"string"},"name":{"description":"Holiday name in the requested language when available","type":"string"},"nationwide":{"type":"boolean"},"regional_scope":{"enum":["National","Regional","Local"],"type":"string"},"start_date":{"format":"date","type":"string"},"subdivisions":{"items":{"type":"string"},"type":"array"},"temporal_scope":{"enum":["FullDay","HalfDay"],"type":"string"},"type":{"enum":["Public","Bank","Optional","School","BackToSchool","EndOfLessons"],"type":"string"}},"required":["name","start_date","end_date","type","nationwide","subdivisions"],"type":"object"},"type":"array"},"is_holiday":{"type":"boolean"},"language":{"type":"string"},"queried_at":{"format":"date-time","type":"string"},"subdivision":{"type":"string"}},"required":["country","date","is_holiday","holidays","queried_at"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.005,"price_match":true,"latency_ms":900,"error":null}],"description_full":"Holiday date check by country or subdivision — determine whether one ISO date is an official public holiday.","last_updated":"2026-09-22T19:23:24.907Z","schemes":["exact"]}