{"uid":"cap_cOaNLVNCfLMskQE6fhMFc","slug":"add-business-days-calculator-5d9e6012","name":"Add Business Days 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/add-business-days?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","date","days"],"properties":{"date":{"type":"string","description":"start date"},"days":{"type":"string","description":"business days to add (negative to subtract)"},"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":{"start":"2026-12-20","result":"2027-01-07","business_days":10}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5YgVVz2tqW1S-wyaMEFEj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates the resulting date after adding (or subtracting) N business days from a start date, respecting public holidays for a given country.","exampleAgentPrompt":"Starting from December 20, 2026, what date is 10 business days later in the US? Skip weekends and American public holidays.","exampleUseCases":[{"title":"Invoice payment deadline calculation","prompt":"Our invoice was issued on March 3 2025 and payment is due in 30 business days — what's the exact due date if the client is in France?"},{"title":"Software release schedule planning","prompt":"We're kicking off a project in Germany on February 1 2026 and need to ship in 20 business days — what's the target release date accounting for German public holidays?"},{"title":"HR onboarding start date","prompt":"A new hire in Japan starts the paperwork process on April 28 2025 — when is their 5th business day (their official first full week complete), considering Japanese holidays?"}],"resultDescription":"A JSON object containing the original start date, the resulting date after adding the specified number of business days (skipping weekends and public holidays for the given country), and a confirmation of the number of business days added.","failureModes":["Invalid or unsupported country code returns an error","Malformed date string causes a parsing error","Missing required parameters (country, date, days) returns a 400-level error","Payment not processed (402 if x402 payment header is absent or insufficient)","Country not covered in the ~120-country database returns an error or empty result"],"whenToPreferThis":"Choose this endpoint when you need date arithmetic that correctly skips both weekends and country-specific public holidays. It covers ~120 countries and is ideal for scheduling, contract deadlines, invoice due dates, or any workflow requiring accurate business-day offsets. It is pay-per-call with no subscription needed, making it efficient for occasional or agent-driven lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:37:17.159Z","isFirstParty":false,"canonicalSlug":"add-business-days-calculator-5d9e6012"}