Malaysia Public Holidays API

Get Available Years

GET /api/years.json

Returns an array of years for which holiday data is available.

Example response:

[2023, 2024, 2025, 2026]

Get Holidays for a Specific Year

GET /api/{year}.json

Returns an array of holidays for the specified year.

Example request: /api/2025.json

Example response:

[
  {
    "date": "Jan 01",
    "holiday_name": "New Year's Day"
  },
  {
    "date": "Jan 29",
    "holiday_name": "Chinese New Year"
  },
  ...
]

Get API Metadata

GET /api/metadata.json

Returns metadata about the API, including:

• last_updated: Timestamp when the data was last updated
• available_years: List of years for which data is available
• failed_years: List of years for which data scraping failed
• total_years_available: Total number of years available
• year_range: Range of years available (e.g., "2023-2026")

Example response:

{
  "last_updated": "2025-06-05T15:44:00.000Z",
  "available_years": [2023, 2024, 2025, 2026],
  "failed_years": [2027],
  "total_years_available": 4,
  "year_range": "2023-2026"
}

JavaScript (Fetch API)

// Get holidays for 2025
fetch('https://sabah-holiday.dydxsoft.my/api/2025.json')
  .then(response => response.json())
  .then(data => {
    console.log(data);
  })
  .catch(error => console.error('Error:', error));

Python (Requests)

import requests

# Get holidays for 2025
response = requests.get('https://sabah-holiday.dydxsoft.my/api/2025.json')
holidays = response.json()
print(holidays)