/api/astro/malayalam_calendar/1 creditMalayalam calendar
A year of Kerala observances on the Malayalam (Kollam era) calendar, which is solar: months begin with the Sun's entry into each sidereal sign, and the year opens at Chingam Sankramam in August. The list covers the twelve Sankramams, the Kerala temple festivals and vratas — Thiruvathira, Makaravilakku, Attukal Pongal, Painkuni Uthram, Guruvayur Ekadasi, the start of Mandalakala — and the pan-Indian days as observed there. Pass year with latitude, longitude and UTC offset. The response is {year, events}, each event {name, date}, in date order; a typical year returns around fifty entries. The year must be between 2006 and 2046. Onam appears here as a single dated entry. For the festival week day by day, with nakshatra timings and the Malayalam day numbers, use /api/astro/onam_calendar/.
https://yogataraapi.prahlad.app/api/astro/malayalam_calendar/Authentication
Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonRequest fields
| Field | Type | Required | Notes |
|---|---|---|---|
| latitude | number (double) | required | Latitude of the place, in decimal degrees. Positive is north, negative is south. Example: 26.9124 for Jaipur, 40.7128 for New York. Minutes and seconds are not accepted - convert first. |
| longitude | number (double) | required | Longitude of the place, in decimal degrees. Positive is east, negative is west. Example: 75.7873 for Jaipur, -74.0060 for New York. Note the sign: a missing minus puts New York in China. |
| timezone_as_float | number (double) | required | UTC offset of the place, in hours, as a decimal. Example: 5.5 for India (UTC+05:30), -5 for New York in winter, 5.75 for Nepal. This is NOT validated against date_time - if the two disagree you get a successful response for the wrong moment, so derive both from the same source. Use the offset in force on that date, not today's: a summer birth in a country with daylight saving needs the summer offset. |
| year | integer | required | Year of birth as a number, e.g. 1990. Four digits. min 2006 · max 2046 |
Example request
curl -X POST https://yogataraapi.prahlad.app/api/astro/malayalam_calendar/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year":2026}'Response
{
"data": {
"year": 2026,
"events": [
{
"name": "Thiruvathira",
"date": "2026-01-03"
},
{
"name": "Makaram Sankramam",
"date": "2026-01-14"
},
{
"name": "Pongal",
"date": "2026-01-14"
},
{
"name": "Makaravilakku",
"date": "2026-01-14"
},
{
"name": "Thai Pooyam",
"date": "2026-02-01"
},
{
"name": "Kumbham Sankramam",
"date": "2026-02-13"
},
{
"name": "Shivarathri",
"date": "2026-02-15"
},
{
"name": "Attukal Pongal",
"date": "2026-02-23"
},
{
"name": "Meenam Sankramam",
"date": "2026-03-15"
},
{
"name": "Matsyavathara Dinam",
"date": "2026-03-21"
},
{
"name": "Shree Rama Navami *Smarta",
"date": "2026-03-26"
},
{
"name": "Painkuni Uthram",
"date": "2026-04-01"
},
{
"name": "Metam Sankramam",
"date": "2026-04-14"
},
{
"name": "Solar New Year",
"date": "2026-04-14"
},
{
"name": "Parashurama Jayanthi",
"date": "2026-04-19"
},
{
"name": "Akshaya Trithiya",
"date": "2026-04-19"
},
{
"name": "Shree Shankara Jayanthi",
"date": "2026-04-21"
},
{
"name": "Narasimha Jayanthi",
"date": "2026-04-30"
},
{
"name": "Chitra Pournami",
"date": "2026-05-01"
},
{
"name": "Kurmavathara Dinam",
"date": "2026-05-01"
},
{
"name": "Itavam Sankramam",
"date": "2026-05-15"
},
{
"name": "Mithunam Sankramam",
"date": "2026-06-15"
},
{
"name": "Karkatakam Sankramam",
"date": "2026-07-16"
},
{
"name": "Guru Poornima",
"date": "2026-07-29"
},
{
"name": "Chingam Sankramam",
"date": "2026-08-17"
},
{
"name": "Malayalam New Year",
"date": "2026-08-17"
},
{
"name": "Onam",
"date": "2026-08-26"
},
{
"name": "Ashtami Rohini",
"date": "2026-09-04"
},
{
"name": "Varaha Jayanthi",
"date": "2026-09-13"
},
{
"name": "Kerala Vinayaka Chathurthi",
"date": "2026-09-14"
},
{
"name": "Rishi Panchami",
"date": "2026-09-15"
},
{
"name": "Kanni Sankramam",
"date": "2026-09-17"
},
{
"name": "Vishwakarma Puja",
"date": "2026-09-17"
},
{
"name": "Vamana Jayanthi",
"date": "2026-09-23"
},
{
"name": "Navarathri",
"date": "2026-10-11"
},
{
"name": "Thulam Sankramam",
"date": "2026-10-17"
},
{
"name": "Durgashtami",
"date": "2026-10-19"
},
{
"name": "Maha Navami",
"date": "2026-10-20"
},
{
"name": "Vijayadashami",
"date": "2026-10-21"
},
{
"name": "Vidyarambham Day",
"date": "2026-10-21"
},
{
"name": "Diwali",
"date": "2026-11-08"
},
{
"name": "Vrischikam Sankramam",
"date": "2026-11-16"
},
{
"name": "Mandalakala Begins",
"date": "2026-11-16"
},
{
"name": "Guruvayur Ekadasi",
"date": "2026-11-20"
},
{
"name": "Karthigai Deepam",
"date": "2026-11-24"
},
{
"name": "Dhanu Sankramam",
"date": "2026-12-16"
},
{
"name": "Mukkoti Ekadasi",
"date": "2026-12-20"
},
{
"name": "Geeta Dinam",
"date": "2026-12-20"
},
{
"name": "Thiruvathira",
"date": "2026-12-24"
},
{
"name": "Mandalakala Pooja",
"date": "2026-12-26"
}
]
},
"message": "successful",
"is_error": false
}Captured from a real call using the exact request above. Results sit under data.
Errors
Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.