Skip to main content
GET
Malaysia Public Holidays

Query Parameters

year
integer

Calendar year to return (must appear in yearOptions from /api/v1/public-holiday/meta). Omit to use defaultYear (the recommended active year for the product).

coverage
enum<string>

Geographic coverage preset. all returns every row (ignores state). nationwide returns only rows where states lists all 16 territories (nationwide holidays). Omit to use optional state filtering: with state, returns nationwide rows plus rows that include that territory.

Available options:
all,
nationwide
state
enum<string>

State/territory filter (slug format). Ignored when coverage=all. Accepted values: johor, kedah, kelantan, melaka, negeri-sembilan, pahang, perak, perlis, pulau-pinang, sabah, sarawak, selangor, terengganu, kuala-lumpur, labuan, putrajaya.

Available options:
johor,
kedah,
kelantan,
melaka,
negeri-sembilan,
pahang,
perak,
perlis,
pulau-pinang,
sabah,
sarawak,
selangor,
terengganu,
kuala-lumpur,
labuan,
putrajaya

Response

Malaysia public holiday list with optional year, coverage, and state filters. Nationwide rows list all 16 territory slugs. Use /api/v1/public-holiday/meta for filter options.

apiVersion
string
required
baseUrl
string
required
defaultYear
integer
required
yearOptions
object[]
required
query
object
required
total
integer
required
meta
object
required
holidays
object[]
required