{"uid":"cap_iZa-zGSQkEVIV2n4uJQCC","slug":"1gateway-business-days-calculator-70fad653","name":"1gateway Business Days Calculator","description":"Use when computing due dates, SLAs, settlement or delivery dates. Input: start date, then days (add -260..260 business days) or end (count business days between), optional country KR, US, GB, DE, FR or JP for public holidays (omit = weekends only). Output: JSON result date or business/calendar day counts, holidays skipped on the way, holiday scope. Example: ?start=2026-12-22&days=5&country=US","url":"https://1gateway.dev/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"],"type":"string"},"queryParams":{"type":"object","required":["start"],"properties":{"end":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","examples":["2027-01-15"],"description":"Count business days from start (excluded) to end (included), at most 2 years apart; ignored when days is given"},"days":{"type":"integer","maximum":260,"minimum":-260,"examples":[5],"description":"Business days to add (negative = go back); give days or end (days wins if both)"},"start":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","examples":["2026-12-22"],"description":"Start date YYYY-MM-DD (2004–2099)"},"country":{"enum":["KR","US","GB","DE","FR","JP"],"type":"string","examples":["US"],"description":"Public holiday calendar (omit for weekends only)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["start","country","mode","holidaysSkipped","holidayScope","supportedCountries","notes","attribution"],"properties":{"end":{"type":"string"},"days":{"type":"integer"},"mode":{"type":"string"},"notes":{"type":"array","items":{"type":"string"}},"start":{"type":"string"},"country":{"type":"string"},"countRule":{"type":"string"},"resultDate":{"type":"string"},"attribution":{"type":"string"},"businessDays":{"type":"integer"},"calendarDays":{"type":"integer"},"holidayScope":{"type":"string"},"resultWeekday":{"type":"string"},"holidaysSkipped":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"name":{"type":"string"}}}},"startIsBusinessDay":{"type":"boolean"},"supportedCountries":{"type":"array","items":{"type":"string"}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Qbe6FwCLsO8JCrGeSih-x","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates future/past business dates or counts business days between two dates, with optional public holiday calendars for US, UK, Germany, France, Japan, and South Korea.","exampleAgentPrompt":"If I start an SLA on December 22, 2026, when does it end after 5 US business days — can you calculate the result date skipping US public holidays?","exampleUseCases":[{"title":"SLA deadline from start date","prompt":"Our support SLA is 10 business days. A ticket was opened on March 3, 2025 in the US — what date does the SLA expire, skipping US public holidays?"},{"title":"Settlement date for financial trade","prompt":"A trade settles T+2 business days. If the trade date is April 14, 2025, what is the settlement date? We're using the UK holiday calendar."},{"title":"Count working days between two dates","prompt":"How many business days are there between January 1, 2026 and March 31, 2026 in Germany, excluding German public holidays?"}],"resultDescription":"A JSON object containing: the computed result date (when adding days) or business/calendar day counts (when counting between dates), the weekday of the result, a list of public holidays skipped along the way with their names and dates, the holiday scope applied, and metadata including start date, country, and mode.","failureModes":["Missing required 'start' parameter returns an error","Date outside supported range 2004–2099 returns an error","Invalid country code (not KR/US/GB/DE/FR/JP) returns an error","'days' value outside -260 to 260 range returns a validation error","Dates more than 2 years apart when using 'end' mode may be rejected","Malformed date format (not YYYY-MM-DD) returns a parse error"],"whenToPreferThis":"Choose this endpoint when you need accurate business day arithmetic with support for public holiday calendars across major economies (US, UK, Germany, France, Japan, South Korea). Prefer it over generic date libraries when you need holiday-aware calculations without maintaining your own holiday datasets, or when computing SLA deadlines, settlement dates, delivery windows, or contract due dates in a pay-per-call, no-signup context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:12.132Z","isFirstParty":false,"canonicalSlug":"1gateway-business-days-calculator-70fad653"}