Malaysia Holiday API Malaysia Holiday API
API Docs
Free Malaysia Public Holiday API

The Free Malaysia Public Holiday API.

A free, high-integrity public holiday API for Malaysia with federal and state-level coverage. Powered by verified source imports, it is the perfect source of truth for your applications, databases, or Python holidays integration.

Try the API Read Documentation 
{
  "year": 2026,
  "state_code": "SBH",
  "data": [
    {
      "id": 1,
      "name": "Pesta Kaamatan",
      "date": "2026-05-30",
      "scope": "state",
      "state_codes": ["SBH"],
      "is_subject_to_change": false
    }
  ]
}
curl -X GET "https://malaysia-holiday.dydxsoft.my/api/v1/holidays?year=2026&state_code=SBH"
import requests

# Query Malaysia public holidays (python holidays malaysia)
url = "https://malaysia-holiday.dydxsoft.my/api/v1/holidays"
params = {
    "year": 2026,
    "state_code": "SBH"
}

response = requests.get(url, params=params)
holidays = response.json()
print(holidays)
13 States + 3 Federal Territories
Multi-Stage Review Workflow
Real-Time Manual Overrides
PDF & Gazette Source Tracking

Platform Capabilities

Built for enterprise-grade operations.

We provide the tools to ingest, verify, and serve Malaysian holiday data with absolute confidence. No more scraping unreliable sources.

Verified sources

Store PDFs, gazettes, and public state calendars with cryptographic checksums.

Import workflow

Seamless CSV ingestion with automated validation and batch-level review.

Admin review

Expert review interface to confirm or reject holidays before they hit production.

State granularity

Full support for federal, state, and regional holidays with precise geographical scoping.

Manual overrides

Apply emergency corrections and gazetted changes without affecting historical imports.

Date check API

Highly optimized endpoints to verify holiday status for any date and state combination.

The Workflow

From PDF to API in minutes.

Our multi-stage pipeline ensures that every single holiday record is backed by a verified document and confirmed by a human administrator.

1

Source Ingestion

Upload gazettes or state announcements. Each source is tracked and archived.

2

Batch Review

Imports are held in draft batches. Admins cross-reference records against the original source.

3

Global Publication

Approved data is instantly available via our global API nodes with high-availability.

PDF
Sources
99%
Accuracy
Review
Human Checked
API
JSON Output

Developer First

Integration ready.

Query by year, state, or specific dates. Our REST API is versioned and designed for reliability in production applications.

Versioned REST API endpoints
ISO dates + consistent JSON errors
Public endpoints with no API key
cURL / Terminal 
curl "https://malaysia-holiday.dydxsoft.my/api/v1/holidays/check?date=2026-05-30&state=SBH"

{
  "date": "2026-05-30",
  "state_code": "SBH",
  "is_holiday": true,
  "holidays": [
    {
      "name": "Pesta Kaamatan",
      "state_codes": ["SBH"],
      "scope": "state",
      "type": "state",
      "is_subject_to_change": false
    }
  ]
}

Interactive

Try it in the Playground.

No Postman. No terminal. Just pick an endpoint, fill in your parameters, and see the live JSON response — right in your browser.

  • Select endpoint from a list
  • Configure year, state, date — via dropdowns
  • See the live curl command update in real-time
  • Copy the JSON response instantly
Open API Playground
https://malaysia-holiday.dydxsoft.my/api/playground
GET /holidays
GET /holidays/check
GET /states
year: 2026
state: SBH
Send →
HTTP 200 
{
  "data": [
    {
      "name": "Pesta Kaamatan",
      "date": "2026-05-30",
      "scope": "state"
    }
  ],
  "meta": {
    "year": 2026,
    "state": "SBH",
    "count": 1
  }
}