{"uid":"cap_Sol_XngjeCARJLZMFf31c","slug":"holiday-calendar-api-next-public-holiday-140b388d","name":"Holiday Calendar API – Next Public Holiday","description":"Next official public holiday after a date for a supported country or regional subdivision.","url":"https://holidays.use.x402atlas.com/next","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","after"],"properties":{"after":{"type":"string","format":"date","description":"Find the first holiday strictly after this ISO 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","after","queried_at"],"properties":{"note":{"type":"string"},"after":{"type":"string","format":"date"},"country":{"type":"string"},"holiday":{"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"},"queried_at":{"type":"string","format":"date-time"},"subdivision":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"after":"2026-02-01","country":"DE","holiday":{"name":"International Women's Day","type":"Public","end_date":"2026-03-08","nationwide":false,"start_date":"2026-03-08","subdivisions":["DE-BE"],"regional_scope":"Regional","temporal_scope":"FullDay"},"language":"EN","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_NjsD2jjSd8nPlRcYxo1t9","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":"Returns the next official public holiday strictly after a given ISO date for a supported country or optional regional subdivision.","exampleAgentPrompt":"What's the next official public holiday in France (FR) after 2024-07-14 — give me the name and date, and respond in French?","exampleUseCases":[{"title":"Travel itinerary holiday awareness","prompt":"I'm planning a work trip to Italy and arriving on September 20, 2024 — what's the next public holiday after that date in Italy so I know if offices might be closed?"},{"title":"Payroll scheduling around holidays","prompt":"We need to schedule payroll for our German office. Can you find the next official public holiday in Germany after 2024-10-01, and also check the Bavaria subdivision DE-BY specifically?"},{"title":"Automated reminder for upcoming holiday","prompt":"Set up an alert: what's the next national public holiday in Brazil after today's date, 2024-08-01, so I can remind my team in advance?"}],"resultDescription":"Returns a JSON object containing the matched country code, the 'after' date queried, the query timestamp, and a 'holiday' object with the holiday's localized name, start date, end date, type (e.g. public, bank), whether it is nationwide, and any relevant subdivisions. If no holiday is found within a reasonable window, a note field may explain the situation.","failureModes":["Unsupported country code returns a validation error (country not in the supported enum list)","Invalid or malformed ISO date in 'after' parameter returns a 400-level error","Subdivision code that does not match the selected country returns an error","No upcoming holiday found within lookup window may return an empty or null holiday field with an explanatory note","Network or payment failure returns a non-200 response requiring retry"],"whenToPreferThis":"Use this endpoint when you need the single next upcoming public holiday after a specific date for a supported European, Latin American, or South African country, optionally scoped to a regional subdivision. It is ideal for scheduling, payroll, travel planning, or reminder automation where you need the immediate next holiday rather than a full year's list. Prefer sibling endpoints for full-year holiday lists, business-day counting, or business-day addition calculations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:30:17.197Z","isFirstParty":false}