{"uid":"cap_B2bDTjd2vc1uwwBlqP-yb","slug":"business-day-date-calculator-13d5caf4","name":"Business Day Date Calculator","description":"Pay-per-call utilities for AI agents over x402, USDC on Base.","url":"https://agents.crowdspark.me/v1/time/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"],"type":"string"},"queryParams":{"type":"object","required":["start","days"],"properties":{"days":{"type":"string","description":"Whole number of business days, negative to go back (max 1000)"},"start":{"type":"string","description":"Start date YYYY-MM-DD (not counted)"},"country":{"type":"string","description":"Optional ISO 3166 alpha-2, e.g. US"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"days":5,"start":"2026-12-23","result":"2026-12-31","country":"US","calendar_days":8,"start_weekday":"Wednesday","result_weekday":"Thursday","holidays_skipped":[{"date":"2026-12-25","name":"Christmas Day"}],"weekend_days_skipped":2,"start_is_business_day":true}},"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_735y6eqnbpcCvqgptsfDH","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":"Adds or subtracts N business days from a given date, skipping weekends and public holidays for a specified country, returning the result date, weekday, skipped holidays, and working-day status.","exampleAgentPrompt":"What date is 20 business days after December 23, 2026 in the US, skipping weekends and public holidays?","exampleUseCases":[{"title":"SLA deadline for support ticket","prompt":"Our SLA says we need to resolve critical tickets within 10 business days. The ticket was opened on March 3, 2025 in the US — what's the exact due date, and which holidays will be skipped?"},{"title":"Invoice net-30 payment due date","prompt":"I issued an invoice on January 15, 2025 with net-30 business day terms for a UK client. What date is the payment actually due, accounting for UK public holidays and weekends?"},{"title":"Legal filing deadline calculation","prompt":"I need to file a legal response exactly 45 business days after February 10, 2025 in Germany. What's the final deadline date, and were any German public holidays skipped in that period?"}],"resultDescription":"A JSON object with the computed result date (YYYY-MM-DD), its weekday name, a list of public holidays skipped (each with date and name), the number of weekend days skipped, total calendar days elapsed, the number of business days requested, the start date and its weekday, and whether the start date itself is a business day.","failureModes":["Missing required 'start' or 'days' parameter returns an error","Invalid date format (non-YYYY-MM-DD) causes a parse error","Invalid or unsupported ISO country code may return no holiday data or an error","'days' value exceeding 1000 is rejected","Non-integer or malformed 'days' value returns a validation error","Payment not satisfied returns HTTP 402"],"whenToPreferThis":"Choose this endpoint when you need to compute a forward or backward date that skips weekends and country-specific public holidays — ideal for SLA tracking, invoice terms, shipping ETAs, legal deadlines, and payroll cutoffs. Prefer this over generic date-math tools when country-specific holiday calendars are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:04.842Z","isFirstParty":false,"canonicalSlug":"business-day-date-calculator-13d5caf4"}