South AfricaSouth Africa Public Holidays API

Get the public holidays of South Africa with one HTTP request. HolidaysMap covers 195+ countries from 1985 to 2030+, returns JSON, CSV or XML, and starts free with paid plans from just €3/month.

South Africa API details

CountrySouth Africa
Country code (code parameter)ZA
ISO 3166-1 alpha-3ZAF
EndpointGET /api/v1/holidays
Output formatsJSON, CSV, XML

How to get South Africa public holidays

Create a free account, copy your API key from the dashboard, and request a date for South Africa. Use code=ZA or country=South Africa.

cURL

curl "https://holidaysmap.com/api/v1/holidays?key=YOUR_API_KEY&code=ZA&date=01-01-2025"

JavaScript

const response = await fetch(
  'https://holidaysmap.com/api/v1/holidays?key=YOUR_API_KEY&code=ZA&date=01-01-2025',
);
const { count, holidays } = await response.json();

Python

import requests

response = requests.get(
    "https://holidaysmap.com/api/v1/holidays",
    params={"key": "YOUR_API_KEY", "code": "ZA", "date": "01-01-2025"},
)
holidays = response.json()["holidays"]

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ZAHolidays {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://holidaysmap.com/api/v1/holidays?key=YOUR_API_KEY&code=ZA&date=01-01-2025"))
            .GET()
            .build();
        HttpResponse<String> response =
            client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Response format

{
  "count": 1,
  "holidays": [
    {
      "name": "Holiday name",
      "date": "01-01-2025",
      "is_public": true,
      "country": "South Africa",
      "country_code": "ZA"
    }
  ]
}

See the full API documentation for date formats, date ranges and every parameter.

Looking for dates instead of API details? See the South Africa public holidays calendar for 2026 and 2027.