{"uid":"cap_j-xNInTrL9HN6e-7vu_oD","slug":"402utils-business-day-calculator-50c2c59b","name":"402utils Business Day Calculator","description":"Business-day math with real holiday calendars for FR, DE, GB, US, ES, IT, NL, BE (2025-2027, official sources — same datasets as /v1/holidays). Count working/weekend/holiday days in a date range (?from&to&country) or shift a date by N business days (?from&add=10&country). Weekend configurable (?weekend=fri,sat), optional ?region= for Länder/UK divisions. Holidays that suppress a working day are listed by name.","url":"https://402utils.com/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","description":"Inclusive end date — range mode."},"add":{"type":"integer","description":"Business days to add — shift mode (1-780)."},"from":{"type":"string","description":"Start date, YYYY-MM-DD (2025-2027)."},"region":{"type":"string","description":"Optional ISO 3166-2 region (e.g. DE-BY, GB-SCT)."},"country":{"type":"string","description":"ISO 3166-1 alpha-2: FR, DE, GB, US, ES, IT, NL, BE."},"weekend":{"type":"string","description":"Comma list of weekend days (default sat,sun)."}},"description":"Query params. `country`, `from` and exactly one of `to` / `add` required."}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["country","weekend","from"],"properties":{"to":{"type":"string","description":"Range mode only."},"add":{"type":"integer","description":"Shift mode only."},"from":{"type":"string"},"note":{"type":"string","description":"Dataset-level caveat when applicable."},"region":{"type":"string"},"result":{"type":"string","description":"Shift mode: the date N business days after `from`."},"country":{"type":"string"},"weekend":{"type":"array","items":{"type":"string"}},"holidays":{"type":"array","items":{"type":"object","required":["date","name","localName"],"properties":{"date":{"type":"string"},"name":{"type":"string"},"localName":{"type":"string"}}},"description":"Public/bank holidays on weekdays in range (the days actually deducted)."},"weekendDays":{"type":"integer"},"businessDays":{"type":"integer","description":"Range mode: working days (not weekend, not public/bank holiday)."},"calendarDays":{"type":"integer","description":"Range mode: total days, inclusive."}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"to":"2026-07-31","from":"2026-07-01","country":"FR","weekend":["sat","sun"],"holidays":[{"date":"2026-07-14","name":"Bastille Day","localName":"Fête nationale (14 juillet)"}],"weekendDays":8,"businessDays":22,"calendarDays":31}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jPSx-J2kbozRBvDQqIdTZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Counts working days, weekend days, and holidays in a date range, or shifts a date forward by N business days, using official public holiday calendars for 8 European and North American countries.","exampleAgentPrompt":"How many business days are there between March 3 2026 and April 30 2026 in Germany, using the Bavaria region calendar? List any public holidays that fall on weekdays in that period.","exampleUseCases":null,"resultDescription":"Returns the count of business days, weekend days, and calendar days in the range (or the resulting date after shifting), plus a list of named public/bank holidays on weekdays that were excluded, with optional regional holiday coverage and configurable weekend definition.","failureModes":["Missing required 'country' or 'from' parameter returns 400 error","Neither 'to' nor 'add' provided returns 400 — exactly one is required","Unsupported country code (outside FR, DE, GB, US, ES, IT, NL, BE) returns 400 or 422","Date out of supported range (outside 2025-2027) returns 400","Invalid region code for the given country returns 400","Malformed date format (not YYYY-MM-DD) returns 400","'add' value outside 1-780 range returns 400","Payment not included or insufficient returns 402"],"whenToPreferThis":"Use this endpoint when you need authoritative business-day calculations tied to official national and regional public holiday calendars for FR, DE, GB, US, ES, IT, NL, or BE, especially for financial, legal, or contractual deadline math where holidays must be excluded by name. Prefer over generic date libraries when country-specific or region-specific holiday data is required for dates in 2025-2027.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:53:31.149Z","isFirstParty":false}