Skip to content
MyCal Docs

Quick Start

The production base URL is:

https://mycal-api.huijun00100101.workers.dev/v1

No signup, no API key. Rate-limited to 100 requests per minute per IP.

Your first call

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

Response:

{
  "data": {
    "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",
        "states": ["*"]
      }
    ]
  }
}

Common recipes

List all holidays for a state in 2026

Terminal window
curl "https://mycal-api.huijun00100101.workers.dev/v1/holidays?year=2026&state=selangor"

Today’s holiday status

Terminal window
curl "https://mycal-api.huijun00100101.workers.dev/v1/holidays/today?state=kl"

Next upcoming holiday

Terminal window
curl "https://mycal-api.huijun00100101.workers.dev/v1/holidays/next?state=penang&limit=3"

Count working days

Terminal window
curl "https://mycal-api.huijun00100101.workers.dev/v1/business-days?start=2026-03-01&end=2026-03-31&state=selangor"

Find long weekends

Terminal window
curl "https://mycal-api.huijun00100101.workers.dev/v1/holidays/long-weekends?year=2026&state=selangor"

State aliases

Use any of these in the state query parameter. All case-insensitive:

CanonicalAliases
kuala-lumpurkl
pulau-pinangpenang, pg
johorjhr, jb
negeri-sembilanns, n9
sabahsbh, kk

See the full state codes reference for all 19.

Next steps