{"uid":"cap_eUWNQMVTKj6dYbjv8gQuj","slug":"agentstall-za-add-business-days-south-africa-c826f2cd","name":"AgentStall ZA – Add Business Days (South Africa)","description":"Adds or subtracts working days from a date in 100+ countries (any ISO country code), skipping the local weekend and public holidays, and lists the holidays skipped. Verified calendars for South Africa and 10 African countries (Egypt has a Friday-Saturday weekend). Useful for payment terms such as 'within 5 business days', notice periods, delivery estimates and legal or contractual deadlines.","url":"https://agentstall.nilesh-b54.workers.dev/v1/add-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","days"],"properties":{"days":{"type":"string","description":"Business days to add, -1000 to 1000"},"start":{"type":"string","description":"Start date, YYYY-MM-DD"},"country":{"type":"string","description":"ISO country code, e.g. ZA (default), KE, NG, EG, GH, US, GB, DE, IN, AE. Verified calendars for ZA, NG, KE, EG, GH, MA, RW, UG, TZ, MU and BW"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"start":"2026-12-23","result":"2026-12-31","resultWeekday":"Thursday","holidaysSkipped":[{"date":"2026-12-25","name":"Christmas Day"}],"businessDaysAdded":5}},"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_Lv-QhaWNq6BnBz_1kbV_l","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":"Calculates a future or past South African business date by adding or subtracting a given number of working days from a start date, skipping weekends and South African public holidays.","exampleAgentPrompt":"Starting from 2026-12-23, what South African business date lands exactly 5 working days later — skipping weekends and any SA public holidays along the way?","exampleUseCases":[{"title":"Contract payment deadline calculation","prompt":"Our supplier contract says payment is due 10 business days after the invoice date of 2025-09-01. What's the actual South African calendar date that falls on, skipping weekends and local holidays?"},{"title":"Regulatory submission deadline planning","prompt":"I need to figure out what date is 20 South African business days from 2026-03-15 — we have a SARS filing and want to know the exact deadline."},{"title":"Project milestone scheduling","prompt":"We're kicking off a project on 2025-06-16 and need to schedule a handoff exactly 15 South African working days later. What date does that land on, and are there any public holidays we'd be skipping?"}],"resultDescription":"Returns a JSON object containing the original start date, the resulting business date (result), the day of the week of that result (resultWeekday), a list of South African public holidays that were skipped (with date and name), and the number of business days actually added. Negative day inputs return dates in the past.","failureModes":["Missing required query parameters (start or days) returns a 400 error","Invalid date format for start (non-YYYY-MM-DD) returns a parsing error","Days value outside the allowed range of -1000 to 1000 returns a validation error","Unpaid call returns HTTP 402 with PAYMENT-REQUIRED header — payment via x402 v2 (USDC) required","Network or worker timeout may return a 5xx error"],"whenToPreferThis":"Choose this endpoint when you need accurate South African working-day arithmetic that accounts for both weekends and SA public holidays. It is purpose-built for South African business calendars and is ideal for deadline calculations, SLA tracking, financial settlement dates, and regulatory timeline planning in the South African context. Prefer it over generic date-math libraries which do not know SA-specific holidays.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T00:36:22.330Z","isFirstParty":false,"canonicalSlug":"agentstall-za-add-business-days-south-africa-c826f2cd"}