{"uid":"cap_j5aAHU_BLtXv38U8k2paX","slug":"us-business-days-calculator-ecc447b4","name":"US Business Days Calculator","description":"Small pay-per-call utility APIs for AI agents. Pay per request in USDC on Base via x402 (v2, exact scheme). No accounts, no API keys.","url":"https://agent-utils-x402-production.revenue-agent-jw.workers.dev/v1/calendar/us-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":["from","to"],"properties":{"to":{"type":"string","format":"date"},"from":{"type":"string","format":"date"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"businessDays":41,"federalHolidaysOnWeekdays":[{"date":"2026-11-11","name":"Veterans Day"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Dg6Xhq_jCxhqRDYH2-6kO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the count of US business days and federal holidays between two dates","exampleAgentPrompt":"How many US business days are there between January 5, 2026 and March 31, 2026, and are there any federal holidays in that period?","exampleUseCases":[{"title":"Project deadline business day countdown","prompt":"How many business days do I have between today, June 10, 2025, and my deadline of August 15, 2025? I need to know about any federal holidays in that window too."},{"title":"Quarterly payroll working day planning","prompt":"How many US business days are in Q3 2025 — from July 1 to September 30 — and which federal holidays fall on weekdays during that time?"},{"title":"Contract delivery window calculation","prompt":"A vendor contract says delivery is due in 30 business days from contract signing on May 1, 2025. How many total calendar days is that, and which federal holidays are excluded along the way through June 30, 2025?"}],"resultDescription":"A JSON object containing 'businessDays' (integer count of US business days excluding weekends and federal holidays) and 'federalHolidaysOnWeekdays' (array of objects each with 'date' and 'name' for any federal holidays falling on weekdays within the specified range).","failureModes":["Missing 'from' or 'to' query parameters returns a 400 error","Invalid date format (non-ISO 8601) causes a parse error","Date range where 'from' is after 'to' may return 0 or an error","Payment failure via x402 returns 402 Payment Required before processing","Very large date ranges may still return quickly but result in large holiday arrays"],"whenToPreferThis":"Choose this endpoint when you need an accurate count of US business days between two dates with federal holidays accounted for, without requiring an account or API key — especially useful in agentic workflows where you pay per call via USDC on Base. Prefer this over manual calculation or generic date libraries when compliance with the US federal holiday calendar matters for scheduling, payroll, or contract terms.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:38:35.648Z","isFirstParty":false,"canonicalSlug":"us-business-days-calculator-ecc447b4"}