{"uid":"cap_BsADuoSbsWO51D64eCjf4","slug":"agentstall-za-south-african-public-holidays-c78680f1","name":"AgentStall ZA – South African Public Holidays","description":"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.","url":"https://agentstall.nilesh-b54.workers.dev/v1/holidays?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":["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"}}}}},"responseSchema":{"type":"json","example":{"year":2026,"count":12,"country":"KE","holidays":[{"date":"2026-05-27","name":"Idd-ul-Azha","type":"religious","status":"confirmed"}]}},"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_gxHvXaEdC0LJw7qe70Ous","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":"Returns the list of South African public holidays for a given calendar year, including special election days.","exampleAgentPrompt":"Can you get me the full list of South African public holidays for 2026, including any special election days?","exampleUseCases":[{"title":"Annual business calendar planning","prompt":"Pull up all the South African public holidays for 2025 so I can plan our project deadlines around them."},{"title":"Next public holiday lookup","prompt":"What public holidays are coming up in South Africa in the second half of 2026? I want to know the dates and names."},{"title":"Election day awareness for operations","prompt":"Are there any special public holidays like election days in South Africa in 2026 that I need to account for in our staffing schedule?"}],"resultDescription":"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').","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T00:35:36.156Z","isFirstParty":false,"canonicalSlug":"agentstall-za-south-african-public-holidays-c78680f1"}