# AgentStall ZA – South African Public Holidays

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

Returns the list of South African public holidays for a given calendar year, including special election days.

## Facts

- Endpoint: GET https://agentstall.nilesh-b54.workers.dev/v1/holidays?utm_source=zero.xyz
- Price: $0.001/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-south-african-public-holidays-c78680f1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BsADuoSbsWO51D64eCjf4

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-south-african-public-holidays-c78680f1
```

Example prompt: Can you get me the full list of South African public holidays for 2026, including any special election days?

## When to prefer this

Choose this endpoint when you need authoritative South African public holiday data including special election holidays for a specific year, particularly in agentic workflows involving SA business-day calculation, scheduling, compliance deadlines, or calendar enrichment. It is pay-per-call with no subscription overhead.

## Known failure modes

- Year outside valid range 1995–2100 returns a validation error
- Missing 'year' query parameter returns a 400 bad request
- Unpaid or unauthenticated call returns HTTP 402 with PAYMENT-REQUIRED header
- Network timeout or Cloudflare Workers outage returns 5xx

## How this service works

Public holidays for a year in 100+ countries (any ISO country code). South Africa, Nigeria, Kenya, Egypt, Ghana, Morocco, Rwanda, Uganda, Tanzania, Mauritius and Botswana use AgentStall's own verified calendars: observed (substitute) days, Islamic holidays as declared and days moved by decree, each labelled confirmed, reported or estimated. Other countries use the Nager.Date open dataset. Useful for scheduling, payroll, delivery dates and deadlines.

## Output

A JSON object containing the requested year, the total count of public holidays, and an array of holiday objects each with a date (ISO 8601), name, and type (e.g. 'public' or 'special').

## 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": [
      "year"
     ],
     "properties": {
      "year": {
       "type": "string",
       "description": "Calendar year (South Africa 1995-2100; curated African countries 2026-2027; other countries 2000-2040)"
      },
      "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": {
  "year": 2026,
  "count": 12,
  "country": "KE",
  "holidays": [
   {
    "date": "2026-05-27",
    "name": "Idd-ul-Azha",
    "type": "religious",
    "status": "confirmed"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentstall-za-south-african-public-holidays-c78680f1/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)