{"uid":"cap_O_zzny07pXe4Fp6S-ESKI","slug":"sitecheck-business-days-calculator-9492eda6","name":"SiteCheck Business Days Calculator","description":"Working days for a country. mode=between counts the working days after `from` up to and including `to` (up to 5 years) and lists the public holidays skipped; mode=add gives the date that is N working days after `date` (up to 3,650). Weekends are Saturday and Sunday, Friday and Saturday in Israel, and Friday only in Iran and Afghanistan. Nationwide public holidays from Nager.Date; a country with no holiday data is a 404, not charged.","url":"https://api.sitecheck-api.workers.dev/api/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"],"type":"string"},"queryParams":{"type":"object","required":["country"],"properties":{"to":{"type":"string","description":"End date YYYY-MM-DD (mode between; counted)"},"date":{"type":"string","description":"Start date YYYY-MM-DD (mode add)"},"days":{"type":"string","description":"Working days to add, negative to subtract, up to 3,650 in size (mode add)"},"from":{"type":"string","description":"Start date YYYY-MM-DD (mode between; not counted)"},"mode":{"type":"string","description":"between (default) or add"},"country":{"type":"string","description":"ISO 3166 alpha-2 code, e.g. DE, US, IL"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"to":"2027-01-06","from":"2026-12-18","mode":"between","source":"Computed here; public holidays: Nager.Date (nationwide holidays only)","counted":"after from, up to and including to","country":"DE","checkedAt":"2026-10-15T14:00:29.548Z","weekendDays":[0,6],"workingDays":11,"calendarDays":19,"holidaysSkipped":[{"date":"2026-12-25","name":"Erster Weihnachtstag"},{"date":"2027-01-01","name":"Neujahr"}]}},"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_1XeQBHohYbzUMYu_jVyEZ","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":"Calculates the number of working days between two dates, or adds/subtracts business days from a date, accounting for weekends and public holidays by country.","exampleAgentPrompt":"How many business days are there between December 18, 2026 and January 6, 2027 in Germany, skipping weekends and public holidays?","exampleUseCases":[{"title":"Contract payment deadline calculation","prompt":"I signed a contract today, January 15 2025, that requires payment within 30 business days. What is the actual due date in the US, skipping weekends and holidays?"},{"title":"Cross-border delivery SLA check","prompt":"How many working days are between March 1 and March 31 2025 in France? I need to know if our 20-business-day SLA is achievable within that calendar month."},{"title":"Legal notice period calculation","prompt":"I need to send a legal notice in Israel with a 14 business day response window starting April 7 2025 — what date does the deadline land on?"}],"resultDescription":"Returns a JSON object with the computed working days count, calendar days count, the from/to dates, mode used, country, list of holidays skipped (with names and dates), weekend day numbers, and a timestamp of when the check was performed.","failureModes":["Missing required 'country' query parameter returns an error","Invalid country code (not ISO 3166 alpha-2) may return no holiday data or an error","Missing 'from'/'to' for 'between' mode or missing 'date'/'days' for 'add' mode returns an error","Days value exceeding 3,650 is rejected","Invalid date format (not YYYY-MM-DD) causes a parse error","Payment failure via x402 protocol prevents response"],"whenToPreferThis":"Choose this endpoint when you need accurate business day calculations that account for both weekends and country-specific public holidays. It supports multiple countries via ISO codes and offers two modes: counting days between two dates, or projecting a future/past date by a number of working days. Prefer it over manual calendar math or generic date libraries when holiday accuracy per country matters, such as for legal deadlines, SLA tracking, or financial settlement dates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:37:06.908Z","isFirstParty":false,"canonicalSlug":"sitecheck-business-days-calculator-9492eda6"}