Malaysia
Calendar API
Public holidays, school calendar, exam schedules, and business day calculator for all 16 states. Powered by official government gazette data.
Interactive Demos
Try it in your browser
Holiday Checker
Check if any date is a holiday, weekend, or working day for any state.
→Long Weekend Planner
Find all 3+ day long weekends in the year for your state.
→Business Day Calculator
Count working days between dates, or add N business days to any date.
→iCal Feed Generator
Subscribe your Google / Apple / Outlook calendar to live holiday feeds.
Quick Example
One request. One answer.
// Is March 21, 2026 a working day in Selangor? // GET /v1/holidays/check?date=2026-03-21&state=selangor { "date": "2026-03-21", "dayOfWeek": "Saturday", "isHoliday": true, "isWeekend": true, "isWorkingDay": false, "isSchoolDay": false, "holidays": [{ "id": "2026-hari-raya-aidilfitri-1", "name": { "ms": "Hari Raya Aidilfitri", "en": "Eid al-Fitr", "zh": "开斋节" }, "type": "islamic", "status": "confirmed" }] }
Features
Everything you need. Nothing you don't.
16 States + 3 FTs
Every state with correct weekend config. Kedah/Kelantan/Terengganu use Fri-Sat.
Smart Aliases
KL, JB, Penang, n9, kk — all auto-resolve to canonical state codes.
Cuti Ganti
Replacement holidays auto-calculated when holidays fall on weekends.
School Calendar
KPM terms, holidays, and cuti perayaan for both Kumpulan A and B.
Exam Dates
SPM, STPM, MUET, and PT3 schedules from KPM and MPM.
iCal Subscription
Drop-in feed for Google Calendar, Apple Calendar, and Outlook.
MCP Server
12 ready-to-use tools for Claude, ChatGPT, and other AI agents.
TypeScript SDK
Fully typed client with Result pattern — no try/catch required.
Trilingual
Bahasa Melayu, English, and Chinese names for every holiday.
Ready to build?
Three ways to get started — pick what fits.