# AgentStall ZA – Add Business Days (South Africa)

> AgentStall ZA – Add Business Days (South Africa) is a paid API for AI agents from agentstall.nilesh-b54.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-02).

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.

## Facts

- Endpoint: GET https://agentstall.nilesh-b54.workers.dev/v1/add-business-days?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentstall-za-add-business-days-south-africa-c826f2cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eUWNQMVTKj6dYbjv8gQuj

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentstall-za-add-business-days-south-africa-c826f2cd
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "start": "2026-12-23",
  "result": "2026-12-31",
  "resultWeekday": "Thursday",
  "holidaysSkipped": [
   {
    "date": "2026-12-25",
    "name": "Christmas Day"
   }
  ],
  "businessDaysAdded": 5
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentstall-za-add-business-days-south-africa-c826f2cd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentstall.nilesh-b54.workers.dev](https://www.zero.xyz/host/agentstall.nilesh-b54.workers.dev/llms.txt)