Skip to main content
Holiday filter options (meta) and Malaysia public holiday rows with optional coverage and state filters.

Public Holiday Options (Meta)

GET /api/v1/public-holiday/meta Returns public holiday option metadata for building filters and navigation: available years, coverage modes (all vs nationwide), and the full states/territories list. In holiday rows, nationwide means states lists all 16 territory slugs. Use GET /api/v1/public-holiday for rows and aggregates (including date range in meta).

Response Fields

Malaysia Public Holidays

GET /api/v1/public-holiday Returns Malaysia public holiday rows from public-holiday.json. Optional year scopes rows to a calendar year (defaults to defaultYear from the dataset, currently 2026 while that year is published). Optional coverage selects the full dataset for that year, nationwide-only rows, or (by default) you can filter with state for one of 16 states/territories. This endpoint focuses on holiday results and aggregates (including meta.dateRange); use /api/v1/public-holiday/meta for option lists only.

Query Parameters

Response Fields