{"uid":"cap_wb6Rw5xdk-rWi0_lqGh_t","slug":"business-days-calculator-af266c74","name":"Business Days Calculator","description":"Pay-per-call data and web utilities for AI agents: web page to Markdown, SEO audit, email check, domain RDAP/DNS and mail security, ECB FX rates, time zones and business days, SEC EDGAR search and fundamentals, Federal Register, USAspending, weather and NWS alerts, VIN, NPI, ATS jobs. USDC on Base via x402, no sign-up.","url":"https://x402-data-api-x6da.onrender.com/v1/time/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","properties":{"end":{"type":"string","description":"YYYY-MM-DD; if set, counts working days between"},"days":{"type":"integer","description":"working days to add (negative to subtract)"},"start":{"type":"string","description":"YYYY-MM-DD"},"subdiv":{"type":"string","description":"state/province code, e.g. CA"},"country":{"type":"string","description":"ISO 3166-1 alpha-2, default US"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"days":{"type":"number"},"start":{"type":"string"},"result":{"type":"string"},"source":{"type":"string"},"subdiv":{},"country":{"type":"string"},"result_weekday":{"type":"string"},"holidays_skipped":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"name":{"type":"string"}}}},"start_is_business_day":{"type":"boolean"}}}}}}},"responseSchema":{"type":"json","example":{"days":5,"start":"2026-12-22","result":"2026-12-30","source":"python-holidays (MIT licence)","subdiv":null,"country":"US","result_weekday":"Wednesday","holidays_skipped":[{"date":"2026-12-25","name":"Christmas Day"}],"start_is_business_day":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M-qJRAj-P09Kap0hcr1KL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates business days between two dates or adds/subtracts working days from a start date, accounting for public holidays by country and subdivision.","exampleAgentPrompt":"What date will it be exactly 10 business days from December 22, 2026 in the US, and which holidays get skipped along the way?","exampleUseCases":[{"title":"Contract deadline calculation","prompt":"Our contract was signed on January 15, 2025 and payment is due in 30 business days — what's the actual calendar date that lands on in the US?"},{"title":"Cross-border project scheduling","prompt":"How many business days are there between March 3 and April 18, 2025 in the UK? I need to know what holidays fall in that window."},{"title":"State-level payroll deadline","prompt":"What date is 5 business days from today in California? I need to account for California state holidays, not just federal ones."}],"resultDescription":"A JSON object containing the calculated result date (YYYY-MM-DD), the weekday name of that result, the number of days added/counted, the start date, whether the start date is itself a business day, a list of holidays skipped (with dates and names), the country and subdivision used, and the data source attribution.","failureModes":["Invalid date format (not YYYY-MM-DD) returns an error","Unsupported country code returns an error or falls back to US","Invalid subdivision code for a given country returns an error","Missing required start parameter returns a validation error","Providing both 'end' and 'days' parameters simultaneously may cause ambiguous behavior","Payment failure via x402 results in HTTP 402 before computation occurs"],"whenToPreferThis":"Choose this endpoint when you need to calculate working-day deadlines or offsets with accurate public holiday data for a specific country or US state/Canadian province, without setting up your own holiday library. It is especially useful for multi-country scheduling where holiday calendars differ, and for AI agents that need cheap, stateless, pay-per-call date arithmetic without API key management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-19T23:53:57.566Z","isFirstParty":false,"canonicalSlug":"business-days-calculator-af266c74"}