{"uid":"cap_Y5SuKQnJrSpvgapC09P6Y","slug":"business-days-calculator-d33a7988","name":"Business Days Calculator","description":"Add/subtract business days to a date, or count business days between two dates — skipping weekends and optional holidays.","url":"https://datetime.openverbs.com/v1/business-days","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["start"],"properties":{"end":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}","description":"End date to count business days to. Provide this OR `days`."},"days":{"type":"integer","maximum":3650,"minimum":-3650,"description":"Business days to add (negative to subtract). Provide this OR `end`."},"start":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}","description":"Start date (YYYY-MM-DD)."},"weekend":{"type":"array","items":{"type":"integer","maximum":7,"minimum":1},"description":"Weekend weekdays (Mon=1 … Sun=7). Defaults to [6,7]."},"holidays":{"type":"array","items":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}"},"description":"Extra non-working dates to skip (YYYY-MM-DD)."},"timezone":{"type":"string","description":"IANA timezone. Defaults to UTC."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"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_9RjsT_5ycOvgnnz3sPm2G","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":"Add or subtract business days to a date, or count business days between two dates, skipping weekends and optional custom holidays.","exampleAgentPrompt":"How many business days are there between 2025-03-01 and 2025-04-15, skipping Easter on 2025-04-18 and any standard Saturday/Sunday weekends?","exampleUseCases":[{"title":"Invoice payment deadline calculation","prompt":"A client invoice is issued on 2025-07-01 and payment is due in 30 business days — what's the actual due date? Skip weekends and the US Independence Day holiday on 2025-07-04."},{"title":"Project milestone scheduling","prompt":"My project kicks off on 2025-09-01 and I need to know what date falls exactly 45 business days later, excluding Saturdays and Sundays."},{"title":"SLA compliance working-day count","prompt":"Count the number of business days between 2025-01-06 and 2025-01-24, treating only Mondays through Fridays as working days and skipping the MLK Day holiday on 2025-01-20."}],"resultDescription":"Returns the resulting date after adding/subtracting the specified number of business days, or the count of business days between two dates, after skipping weekends and any provided holiday dates.","failureModes":["Missing required 'start' field returns a validation error","Providing both 'days' and 'end' simultaneously causes a conflict error","Invalid date format (not YYYY-MM-DD) returns a pattern mismatch error","'days' value outside the -3650 to 3650 range returns a validation error","Invalid IANA timezone string returns a timezone error","Malformed holiday date strings return a validation error"],"whenToPreferThis":"Choose this endpoint when you need precise business-day arithmetic — adding or subtracting working days or counting them between two dates — especially when custom holidays or non-standard weekend definitions are required. It is purpose-built for scheduling, SLA tracking, invoice due-date calculations, and any workflow that must skip weekends and holidays rather than simply counting calendar days.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:42:14.325Z","isFirstParty":false}