{"uid":"cap_8tgbTfjhSqGw015o0p5Jn","slug":"public-holidays-business-day-calculator-7b711691","name":"Public Holidays & Business-Day Calculator","description":"Public holidays and business-day calculator for agents, ~120 countries: holiday lists, is-this-a-business-day, and add N business days. Paid per call via x402 (USDC on Base).","url":"https://holidays.x402utils.workers.dev/v1/holidays?utm_source=zero.xyz","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["country"],"properties":{"year":{"type":"string","description":"year"},"country":{"type":"string","description":"ISO 3166-1 alpha-2"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"year":2026,"country":"PL","holidays":[{"date":"2026-11-11","name":"Independence Day"}]}},"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_zo6CSXCA_9EvvMwumnSEM","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":"Returns public holidays for a given country and year, and supports business-day calculations such as checking if a date is a business day or adding N business days.","exampleAgentPrompt":"What are all the public holidays in Poland for 2026? I need the full list with dates and names.","exampleUseCases":[{"title":"Payroll business-day scheduling","prompt":"I'm running payroll for our US office — if payday falls on July 4th 2025, what's the next valid business day I should process payments?"},{"title":"International meeting planner","prompt":"We're scheduling a call with our German team in late October 2025 — can you check which days are public holidays in Germany so we avoid scheduling on those?"},{"title":"Contract deadline calculation","prompt":"Our contract says the client has 15 business days to respond after we send the proposal on March 10 2025 in the UK — what's the deadline date?"}],"resultDescription":"A JSON object containing the country code, year, and an array of public holidays each with a date (YYYY-MM-DD) and holiday name. For business-day queries, returns whether a specific date is a business day or a computed future business date.","failureModes":["Unsupported country code returns an error or empty holiday list","Invalid or missing 'country' query parameter results in a 400 bad request","Year out of supported range may return an empty or partial response","Network or payment (x402) authorization failure returns a 402 Payment Required response","Ambiguous country codes (e.g. territories vs. sovereign states) may yield unexpected results"],"whenToPreferThis":"Choose this endpoint when you need authoritative public holiday data for ~120 countries with minimal setup, especially when integrating into agent workflows that require business-day awareness (scheduling, payroll, contract deadlines). It's ideal for AI agents that need to programmatically validate or compute calendar dates across international markets without managing holiday datasets themselves.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T00:36:35.818Z","isFirstParty":false,"canonicalSlug":"public-holidays-business-day-calculator-7b711691"}