Free public JSON API

Cambodia Public Holidays & Khmer Holiday API

Search Cambodian public holidays by date, month or year, with Khmer and English names and a clear confidence level for every result.

ស្វែងរកថ្ងៃឈប់សម្រាកសាធារណៈនៅកម្ពុជា ជាភាសាខ្មែរ និងអង់គ្លេស។

Khmer + EnglishLocalized public holiday names
Transparent sourcesOfficial, reported or computed confidence
Free JSON APISimple filters for apps and websites
Confidence matters. Cambodia fixes its annual public holidays through a sub-decree or Prakas. Lunar dates such as Pchum Ben, Water Festival and Royal Ploughing may remain projections until the governing document is verified. Check confidence, or pass ?official=true.

API endpoints

Use the API from calendars, HR systems, payroll software and Cambodia-focused applications.

RoutePurpose
GET /api/v1/holidaysList and filter Cambodia holidays
GET /api/v1/holidays/{date}Check whether YYYY-MM-DD is a holiday
GET /api/v1/yearsList years held in the database
GET /api/v1/statusView coverage and source audit status
GET /api/v1/sourcesView upstream sources
GET /healthzService liveness

Holiday filters

ParameterExampleMeaning
year2026Calendar year
month4Month, 1–12
day14Day of month, 1–31
from, to2026-01-01Inclusive date range
keypchum_benOne holiday series
officialtrueOnly dates verified against the governing document

Filters combine with AND. For example, ?month=4&day=14 returns 14 April across every stored year.

Examples

Each example is separate. Copy its request, then open the live response to run it against the current dataset.

Holidays by year

Return every stored Cambodian holiday for 2026.

curl 'https://khmerholiday.layhak.dev/api/v1/holidays?year=2026'
Live response
JSON response
Loading current response…

Holidays by year and month

Combine filters to return April 2026 holidays.

curl 'https://khmerholiday.layhak.dev/api/v1/holidays?year=2026&month=4'
Live response
JSON response
Open this section to load the current response.

Check one date

Find out whether 14 April 2026 is a public holiday.

curl 'https://khmerholiday.layhak.dev/api/v1/holidays/2026-04-14'
Live response
JSON response
Open this section to load the current response.

Find a holiday series

Return every stored Pchum Ben date.

curl 'https://khmerholiday.layhak.dev/api/v1/holidays?key=pchum_ben'
Live response
JSON response
Open this section to load the current response.

Official dates only

Exclude every date not yet verified against the governing document.

curl 'https://khmerholiday.layhak.dev/api/v1/holidays?year=2027&official=true'
Live response
JSON response
Open this section to load the current response.

Data confidence

ValueMeaning
officialVerified against the signed sub-decree or Prakas.
reportedPublished by a reputable source and corroborated where possible.
computedProjected from the lunisolar calendar and may shift.