{"uid":"cap_VuGjjpnboNFpdilPu0aIZ","slug":"business-day-deadline-api-add-subtract-business-days-a3bdfa43","name":"Business Day & Deadline API – Add/Subtract Business Days","description":"Verified, always-current business-day arithmetic for ~200 countries incl. subdivisions (German Bundeslaender, US states) and correct per-country weekend rules (e.g. Fri/Sat in Egypt). Informational only — verify legally binding deadlines with the competent authority. Not legal advice.","url":"https://businessdayapi.com/v1/add?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","days","country"],"properties":{"days":{"type":"integer","description":"business days to add (negative = subtract)"},"start":{"type":"string","description":"ISO start date YYYY-MM-DD"},"region":{"type":"string","description":"optional ISO 3166-2 subdivision suffix, e.g. BY (Bavaria), CA (California)"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code, e.g. DE, US, JP"},"weekend":{"type":"string","description":"optional override: sat-sun | fri-sat | custom:THU,FRI"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"days":3,"start":"2026-04-01","source":"nager.date","country":"DE","skipped":[{"date":"2026-04-03","reason":"holiday","holidayName":"Karfreitag"}],"resultDate":"2026-04-08","verifiedAt":"2026-08-17T00:00:00Z"}},"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_VC_Vz73PXBqJrW5LESP8r","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":"Calculates a future or past business date by adding or subtracting a specified number of business days from a start date, accounting for public holidays and weekend rules across ~200 countries and their subdivisions.","exampleAgentPrompt":"What date is 10 business days after April 1, 2026 in Germany — specifically Bavaria — and which holidays or weekends does it skip?","exampleUseCases":[{"title":"Contract notice period deadline","prompt":"Our contract says we need to give 14 business days' written notice before terminating. If we send the notice today, May 15 2025, what's the earliest termination date for a UK-based counterparty?"},{"title":"Invoice payment window calculation","prompt":"We issue an invoice today, June 3 2025, with net-30 business days payment terms for a client in Japan. What calendar date is the payment due, skipping Japanese public holidays?"},{"title":"US state-specific legal filing deadline","prompt":"A California court order was issued on March 10 2026 and requires a response within 20 business days under California rules. What is the response deadline date, accounting for CA state holidays and standard Sat-Sun weekends?"}],"resultDescription":"A JSON object containing the computed result date (YYYY-MM-DD), the original start date and days-requested, the country code used, a list of skipped dates with their reason (holiday or weekend) and holiday name where applicable, the data source (nager.date), and a verifiedAt timestamp indicating when the holiday data was last confirmed.","failureModes":["Missing required query parameters (start, days, country) returns a 400 error","Invalid or unsupported ISO country code returns an error or empty holiday data","Unsupported subdivision code may silently fall back to country-level holidays","Negative days value (subtraction) may not be supported by all country calendars","Holiday data may lag for newly announced public holidays; verifiedAt timestamp indicates data freshness","Payment failure via x402 returns 402 Payment Required before computation is attempted"],"whenToPreferThis":"Choose this endpoint when you need verified, up-to-date business-day arithmetic across international jurisdictions, especially when subdivision-level accuracy (e.g. German Bundesländer, US states) or non-standard weekend rules (e.g. Friday–Saturday in Egypt) matter. It is preferable over generic date-math libraries that lack maintained holiday databases, or over building custom holiday calendars. It is informational and should not replace legal counsel for binding deadlines.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:39:44.154Z","isFirstParty":false,"canonicalSlug":"business-day-deadline-api-add-subtract-business-days-a3bdfa43"}