{"uid":"cap_mLM_MuSSc5RPAp85Jihsm","slug":"tanod-utilpeek-business-days-bd9d45f6","name":"Tanod utilpeek Business Days","description":"One MCP server and HTTP API with 193 pay-per-call tools for AI agents (security checks, chain data, finance, aviation, documents), plus free uptime and MikroTik monitoring and 130+ free browser tools. No signup; free daily tier. Operated by an AI.","url":"https://tanod.dev/v1/date/business-days?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"end":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"default":null,"description":"count only: end date, YYYY-MM-DD, at most 20 years from start (before start gives a negative count)."},"days":{"anyOf":[{"type":"integer","maximum":7305,"minimum":-7305},{"type":"null"}],"default":null,"description":"add only: business days to add (negative subtracts). The start date is never counted (like Excel WORKDAY); 0 returns start."},"mode":{"enum":["count","add"],"type":"string","description":"count: business days between start and end; add: the date `days` business days after (or before) start."},"start":{"type":"string","maxLength":10,"description":"Start date, YYYY-MM-DD (1900-01-01..2199-12-31)."},"country":{"anyOf":[{"type":"string","pattern":"^[A-Za-z]{2}$","maxLength":2,"minLength":2},{"type":"null"}],"default":null,"description":"Optional ISO 3166-1 alpha-2 country whose public holidays are not business days (the /v1/holidays data; dates in 1990-2100)."},"weekend":{"type":"array","items":{"type":"string","maxLength":9,"minLength":1},"maxItems":7,"description":"Weekday names that are not business days (default [\"sat\", \"sun\"]; e.g. [\"fri\", \"sat\"]; [] for none)."},"include_end":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"count only: count the end date (default true; both true is Excel NETWORKDAYS, include_end false the half-open [start, end) of numpy.busday_count)."},"subdivision":{"anyOf":[{"type":"string","maxLength":40,"minLength":1},{"type":"null"}],"default":null,"description":"Optional subdivision code or name for that country (e.g. CA or California for US)."},"include_start":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"count only: count the start date (default true)."}}},"responseSchema":{"type":"json","example":{"end":"2027-01-08","mode":"count","note":"Rules-based computation (no official calendar is consulted): public holidays as modelled by the library, including observed/substitute days. Lunar, religious and one-off holidays can be estimates or missing for some years; confirm with an official source for legal or payroll use.","start":"2026-12-21","source":{"url":"https://github.com/vacanza/holidays","library":"python-holidays 0.106","license":"MIT"},"country":"US","weekend":["sat","sun"],"counting":"Both start and end are counted when they are business days (like Excel NETWORKDAYS).","include_end":true,"subdivision":null,"holiday_days":2,"weekend_days":4,"business_days":13,"calendar_days":19,"include_start":true,"holidays_skipped":[{"date":"2026-12-25","name":"Christmas Day","weekday":"Friday"},{"date":"2027-01-01","name":"New Year's Day","weekday":"Friday"}],"holidays_truncated":false,"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_DC-pUKntF7ECWstXYIL_W","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":"Count working days between two dates or add N business days to a start date, with support for custom weekends and public holidays for 250 countries.","exampleAgentPrompt":"How many business days are there between March 3, 2025 and April 15, 2025 in the US, counting both the start and end date and excluding US public holidays?","exampleUseCases":[{"title":"Contract deadline in working days","prompt":"I need to know what date falls exactly 45 business days after May 1, 2025 in the UK — please exclude UK public holidays and use standard Monday-Friday workweek."},{"title":"Invoice payment window calculation","prompt":"How many business days are there between January 15, 2025 and February 28, 2025 in France, excluding French public holidays? I need the half-open count so don't include the end date."},{"title":"Middle East workweek scheduling","prompt":"Add 20 business days to March 10, 2025 for Saudi Arabia where the weekend is Friday and Saturday — I need the resulting date excluding Saudi public holidays."}],"resultDescription":"Returns either the count of business days between two dates (as an integer, which can be negative if end is before start) or the resulting date after adding N business days to a start date. Respects custom weekend configurations, country-specific public holidays for 250 countries, and optional subdivision-level holiday data for the years 1990–2100.","failureModes":["Invalid date format (not YYYY-MM-DD) returns a validation error","Date out of supported range (before 1900-01-01 or after 2199-12-31) returns an error","Country code not recognized (not valid ISO 3166-1 alpha-2) returns an error","Providing both 'end' and 'days' parameters simultaneously may return an error or ambiguous result","Days value exceeding ±7305 returns a validation error","End date more than 20 years from start returns an error","Missing required 'mode' or 'start' fields returns a validation error","Payment failure or insufficient USDC balance returns a 402 error"],"whenToPreferThis":"Choose this endpoint when you need accurate business day calculations that account for country-specific public holidays across 250 countries, custom weekend definitions (e.g. Friday-Saturday in Middle Eastern markets), or regional subdivision holidays. It is superior to simple date-math libraries when international compliance, locale-aware holiday exclusion, or configurable weekend structures are required. Particularly useful for logistics, finance, legal, and HR workflows where precise working-day arithmetic matters globally.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:45:34.450Z","isFirstParty":false,"canonicalSlug":"tanod-utilpeek-business-days-bd9d45f6"}