free · no auth · hosted in south africa

south african public holidays api

get a complete list of south african public holidays for any year. includes automatically calculated sunday observance and easter-based dates like good friday and family day.

try it

year (e.g. 2025)

// response will appear here

endpoint

GET https://api.zanode.co.za/api/holidays

parameter	type	description
year	integer	the year to calculate holidays for. defaults to the current year if omitted.

response

{
  "status": "success",
  "data": {
    "year": 2025,
    "holidays": [
      { "date": "2025-01-01", "name": "New Year's Day" },
      { "date": "2025-03-21", "name": "Human Rights Day" },
      { "date": "2025-04-18", "name": "Good Friday" },
      { "date": "2025-04-21", "name": "Family Day" }
    ]  // ... all 12 public holidays
  }
}

code examples

curl

curl "https://api.zanode.co.za/api/holidays?year=2026"

javascript

const res = await fetch(
  "https://api.zanode.co.za/api/holidays?year=2025"
);
const { data } = await res.json();
const isHoliday = data.holidays.some(h => h.date === "2025-04-18");

want the full zanode platform?

git-push deploys, managed postgres, and predictable pricing on south african servers.

join the waitlist for a 3-month trial when we launch. no credit card required.