Khmer Calendar Developer API

# 1. Generate an instant 14-day trial key (or get one below)
curl -s "https://khc.loemheng.com/api/v1/trial?email=your_email@example.com" | jq .

# 2. Query today's Khmer lunar date & holidays using your API key
curl -s -H "x-api-key: YOUR_API_KEY" "https://khc.loemheng.com/api/v1/today" | jq .

# 3. Convert any Gregorian date (e.g. 2026-10-24) to Khmer lunar details
curl -s -H "x-api-key: YOUR_API_KEY" "https://khc.loemheng.com/api/v1/date?date=2026-10-24&lang=en" | jq .

// Click "Send Request" above to view live API output...

# Recommended: Pass via custom header
x-api-key: khc_trial_your_key_here

# Alternative: Standard Authorization Bearer
Authorization: Bearer khc_trial_your_key_here

# Alternative: Query Parameter
https://khc.loemheng.com/api/v1/today?api_key=khc_trial_your_key_here

curl -s "https://khc.loemheng.com/api/v1/trial?email=developer@phnompenh.dev" | jq .

{
  "success": true,
  "message": "Your 14-day free trial API key has been created successfully.",
  "api_key": "khc_trial_19283f_8a3d7b92...",
  "plan": "14-Day Free Trial",
  "trial_days_remaining": 14,
  "quota_requests": 10000,
  "rate_limit_per_minute": 60,
  "expires_at": "2026-11-07T10:30:00.000Z",
  "pricing_cambodia": {
    "starter": "$6/month (~24,000 KHR) - 50,000 req/mo",
    "business": "$19/month (~78,000 KHR) - 500,000 req/mo",
    "enterprise": "$49/month (~200,000 KHR) - 5,000,000+ req/mo",
    "accepted_payments": ["Bakong KHQR (ABA, Wing, ACLEDA, Canadia)", "ABA Bank Transfer", "Visa / Mastercard"]
  }
}

{
  "success": true,
  "data": {
    "timezone": "Asia/Phnom_Penh",
    "gregorian_date": "2026-10-24",
    "year": 2026,
    "month": 10,
    "day": 24,
    "day_of_week": 6,
    "weekday": "ថ្ងៃសៅរ៍",
    "khmer_date": "ថ្ងៃសៅរ៍ ១៤កើត ខែអស្សុជ ឆ្នាំមមែ ឆស័ក ព.ស. ២៥៧០",
    "lunar_date": "១៤កើត ខែអស្សុជ",
    "khmer_details": {
      "lunar_day": 14,
      "lunar_day_khmer": "១៤",
      "is_waxing": true,
      "phase_type": "waxing",
      "lunar_phase_text": "១៤កើត",
      "lunar_month_name": "អស្សុជ",
      "lunar_month_index": 10,
      "is_full_month": false,
      "be_year": 2570,
      "be_year_khmer": "២៥៧០",
      "animal_year": "មមែ",
      "sak": "ឆស័ក"
    },
    "moon": {
      "emoji": "🌔",
      "phase_key": "waxing-gibbous",
      "name": "ព្រះច័ន្ទជិតពេញ (Waxing Gibbous)"
    },
    "buddhist_day": {
      "is_holy_day": true,
      "is_uposatha": false,
      "is_kaor": true,
      "name": "ថ្ងៃកោរ"
    },
    "is_official_holiday": false,
    "official_holidays": [],
    "events": []
  },
  "meta": {
    "timestamp": "2026-10-24T02:30:00.000Z",
    "language": "khmer"
  }
}

GET https://khc.loemheng.com/api/card?date=2026-10-24&theme=teal&template=modern

<iframe src="https://khc.loemheng.com/embed" width="340" height="420" frameborder="0" style="border-radius:12px; border:1px solid #e2e8f0;"></iframe>

POST https://khc.loemheng.com/mcp
GET  https://khc.loemheng.com/mcp (Tools catalog)

// Modern async/await with native fetch and API key
async function getKhmerCalendarToday() {
  const apiKey = 'YOUR_API_KEY_OR_TRIAL_KEY'; // e.g. khc_trial_... or khc_live_...
  const response = await fetch('https://khc.loemheng.com/api/v1/today?timezone=Asia/Phnom_Penh', {
    headers: {
      'x-api-key': apiKey,
    },
  });
  if (!response.ok) throw new Error(`API Error: ${response.status}`);
  const result = await response.json();
  
  console.log('Today:', result.data.khmer_date);
  console.log('Is Holy Day (ថ្ងៃសីល/ថ្ងៃកោរ):', result.data.buddhist_day.is_holy_day);
  console.log('Moon Phase:', result.data.moon.emoji, result.data.moon.name);
  return result.data;
}

getKhmerCalendarToday();

import requests

def get_khmer_today():
    url = "https://khc.loemheng.com/api/v1/today"
    headers = {
        "x-api-key": "YOUR_API_KEY_OR_TRIAL_KEY" # e.g. khc_trial_...
    }
    params = {"timezone": "Asia/Phnom_Penh", "lang": "km"}
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    data = response.json()["data"]
    
    print(f"Date: {data['khmer_date']}")
    print(f"Lunar: {data['lunar_date']}")
    print(f"Holy Day: {data['buddhist_day']['name']}")
    return data

if __name__ == "__main__":
    get_khmer_today()

# Query today's calendar details with API key
curl -s "https://khc.loemheng.com/api/v1/today" \
  -H "x-api-key: YOUR_API_KEY_OR_TRIAL_KEY" \
  -H "Accept: application/json" | jq .data.khmer_date

<?php
$apiKey = "YOUR_API_KEY_OR_TRIAL_KEY";
$options = [
    "http" => [
        "header" => "x-api-key: " . $apiKey . "\r\n" .
                    "Accept: application/json\r\n"
    ]
];
$context = stream_context_create($options);
$url = "https://khc.loemheng.com/api/v1/today?lang=en";
$json = file_get_contents($url, false, $context);
$response = json_decode($json, true);

if ($response['success']) {
    $data = $response['data'];
    echo "Khmer Date: " . $data['khmer_date'] . "\n";
    echo "Moon: " . $data['moon']['emoji'] . " " . $data['moon']['name'] . "\n";
}
?>

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

type CalendarResponse struct {
	Success bool `json:"success"`
	Data    struct {
		KhmerDate string `json:"khmer_date"`
		LunarDate string `json:"lunar_date"`
	} `json:"data"`
}

func main() {
	req, err := http.NewRequest("GET", "https://khc.loemheng.com/api/v1/today", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("x-api-key", "YOUR_API_KEY_OR_TRIAL_KEY")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var result CalendarResponse
	if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
		panic(err)
	}

	fmt.Println("Khmer Date:", result.Data.KhmerDate)
}

import 'dart:convert';
import 'package:http/http.dart' as http;

Future<void> fetchKhmerDate() async {
  final url = Uri.parse('https://khc.loemheng.com/api/v1/today');
  final response = await http.get(
    url,
    headers: {
      'x-api-key': 'YOUR_API_KEY_OR_TRIAL_KEY',
    },
  );

  if (response.statusCode == 200) {
    final data = jsonDecode(response.body)['data'];
    print('Khmer Date: ${data['khmer_date']}');
    print('Moon: ${data['moon']['emoji']}');
  }
}

final url = Uri.parse('https://khc.loemheng.com/api/v1/today'); final response = await http.get(url); if (response.statusCode == 200) { final data = jsonDecode(response.body)['data']; print('Khmer Date: ${data['khmer_date']}'); print('Moon: ${data['moon']['emoji']}'); } }