MyCal
← All demos

Holiday Checker

Pick a date and a state — get back holiday status, weekend status, working day status, and any overlapping school calendar entries. One API call.

 
GET https://mycal-api.huijun00100101.workers.dev/v1/holidays/check?date=2026-03-21&state=selangor

What's happening

Behind the scenes, this calls GET /v1/holidays/check with your chosen date and state. The API resolves state aliases (so kl, selangor, or sgr all work), looks up the state's current weekend configuration (Kedah, Kelantan, and Terengganu use Fri–Sat), and checks against the federal + state gazette for that date.

Try these dates

  • 2026-03-21 — Hari Raya Aidilfitri (Saturday, Islamic holiday + weekend)
  • 2026-08-31 — Hari Kebangsaan (Monday, federal holiday)
  • 2026-01-01 — New Year (varies by state)
  • 2026-09-12 — Kedah governor's birthday (state-only)

See /docs/rest-api/holidays for the full endpoint reference.