{"uid":"cap_sq1xOn6VnxX-yf_Xyhnil","slug":"agent-time-place-business-days-calculator-4fd6c790","name":"Agent Time & Place — Business Days Calculator","description":"Geocoding, timezones, holidays, business days, sun times, FX and distances for AI agents. Deterministic, sub-cent, no API key: payment is authentication (x402).","url":"https://time-place.agent-utils.workers.dev/v1/business-days","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","from"],"properties":{"to":{"type":"string","format":"date","description":"Count business days from 'from' to 'to' inclusive."},"add":{"type":"integer","description":"Business days to add (negative to subtract). Mutually exclusive with 'to'."},"from":{"type":"string","format":"date"},"region":{"type":"string","description":"Optional ISO 3166-2 code for regional holidays"},"country":{"type":"string"},"weekend":{"type":"string","default":"sat,sun","description":"Comma list of weekend day names"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"to":{"type":"string"},"from":{"type":"string"},"mode":{"enum":["add","count"],"type":"string"},"start":{"type":"string"},"result":{"type":"string"},"country":{"type":"string"},"holidays":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"name":{"type":"string","description":"English name"},"types":{"type":"array","items":{"type":"string"}},"regions":{"type":["array","null"],"items":{"type":"string"},"description":"ISO 3166-2 codes when regional"},"localName":{"type":"string"},"nationwide":{"type":"boolean"}}}},"weekendDays":{"type":"integer"},"businessDays":{"type":"integer"},"calendarDays":{"type":"integer"},"skippedHolidays":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"name":{"type":"string","description":"English name"},"types":{"type":"array","items":{"type":"string"}},"regions":{"type":["array","null"],"items":{"type":"string"},"description":"ISO 3166-2 codes when regional"},"localName":{"type":"string"},"nationwide":{"type":"boolean"}}}},"skippedWeekendDays":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"mode":"add","start":"2026-11-25","result":"2026-12-01","country":"US","businessDays":3,"skippedHolidays":[{"date":"2026-11-26","name":"Thanksgiving Day","types":["Public"],"regions":null,"localName":"Thanksgiving Day","nationwide":true}],"skippedWeekendDays":2}},"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_0bKvVzXZqjgtJlddaFWdo","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":"Counts business days between two dates or adds/subtracts business days from a start date, accounting for country-specific public holidays and configurable weekends.","exampleAgentPrompt":"How many business days are there between November 25 and December 31 in the US, accounting for Thanksgiving and Christmas?","exampleUseCases":[{"title":"Contract deadline in working days","prompt":"Our contract says payment is due 30 business days from November 1st 2025 in the UK — what calendar date does that fall on?"},{"title":"SLA compliance check for support ticket","prompt":"A support ticket was opened on January 15 2026 and closed on February 10 2026 in Germany — how many business days did that take?"},{"title":"Regional holiday-aware project timeline","prompt":"I need to know what date is 20 business days from March 3 2026 in California, US — make sure to exclude any California-specific state holidays."}],"resultDescription":"A JSON object containing the computation mode (add or count), the start date, the result date or business day count, the country, total business days, and arrays of skipped holidays (with date, name, local name, types, and regional scope) and skipped weekend days.","failureModes":["Missing required 'country' or 'from' parameters returns a 400 error","Mutually exclusive 'to' and 'add' parameters both provided causes an error","Invalid date format (non-ISO 8601) causes a parse error","Unrecognized country code returns an error or empty holiday list","Invalid ISO 3166-2 region code may return no regional holidays","Payment not provided or insufficient returns a 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when you need deterministic, holiday-aware business day arithmetic for a specific country or region, especially when you need the list of skipped holidays by name. It requires no API key — payment via x402 is the authentication mechanism, making it suitable for agent pipelines without credential management. Prefer it over generic date libraries when country-specific public holidays matter for accuracy.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:47:37.250Z","isFirstParty":false}