/api/astro/kannada_calendar/1 creditKannada calendar
A year of festivals and observances as kept in Karnataka. The Kannada calendar is amanta luni-solar on the Shaka era — months run from one new moon to the next — and its festival set covers the Ekadashis, the twelve Sankrantis, eclipses, and the regional days: Yugadi, Gowri Habba, Kamanahabba, the Karaga festival, Sakat and Karwa Chauth. Pass year with latitude, longitude and UTC offset. The place matters because several observances are fixed by the tithi at sunrise or by moonrise. The response is {year, events} with each event {name, date}, in date order, typically well over a hundred entries. Eclipse rows carry a type suffix, for example 'Surya Grahan *Valayakara'. The year must be between 2006 and 2046.
https://yogataraapi.prahlad.app/api/astro/kannada_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/kannada_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
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"year\": 2026, \"events\": [{\"name\": \"Sakat Chauth\", \"date\": \"2026-01-06\"}, {\"name\": \"Shattila Ekadashi\", \"date\": \"2026-01-14\"}, {\"name\": \"Makara Sankranti\", \"date\": \"2026-01-14\"}, {\"name\": \"Pongal\", \"date\": \"2026-01-14\"}, {\"name\": \"Mauni Amavas\", \"date\": \"2026-01-18\"}, {\"name\": \"Vasant Panchami\", \"date\": \"2026-01-23\"}, {\"name\": \"Ratha Saptami\", \"date\": \"2026-01-25\"}, {\"name\": \"Bhishma Ashtami\", \"date\": \"2026-01-26\"}, {\"name\": \"Jaya Ekadashi\", \"date\": \"2026-01-29\"}, {\"name\": \"Vijaya Ekadashi\", \"date\": \"2026-02-13\"}, {\"name\": \"Kumbha Sankranti\", \"date\": \"2026-02-13\"}, {\"name\": \"Maha Shivaratri\", \"date\": \"2026-02-15\"}, {\"name\": \"Surya Grahan *Valayakara\", \"date\": \"2026-02-17\"}, {\"name\": \"Amalaki Ekadashi\", \"date\": \"2026-02-27\"}, {\"name\": \"Chandra Grahan *Purna\", \"date\": \"2026-03-03\"}, {\"name\": \"Holi Hunnime\", \"date\": \"2026-03-03\"}, {\"name\": \"Kamanahabba\", \"date\": \"2026-03-03\"}, {\"name\": \"Holi\", \"date\": \"2026-03-04\"}, {\"name\": \"Sheetala Ashtami\", \"date\": \"2026-03-11\"}, {\"name\": \"Basoda\", \"date\": \"2026-03-11\"}, {\"name\": \"Papamochani Ekadashi\", \"date\": \"2026-03-15\"}, {\"name\": \"Meena Sankranti\", \"date\": \"2026-03-15\"}, {\"name\": \"Nutan Varsh Prarambha\", \"date\": \"2026-03-19\"}, {\"name\": \"Gudi Padwa\", \"date\": \"2026-03-19\"}, {\"name\": \"Chaitra Navratri\", \"date\": \"2026-03-19\"}, {\"name\": \"Yugadi\", \"date\": \"2026-03-19\"}, {\"name\": \"Gauri Puja\", \"date\": \"2026-03-21\"}, {\"name\": \"Soubhagya Gauri Vrat\", \"date\": \"2026-03-21\"}, {\"name\": \"Yamuna Chhath\", \"date\": \"2026-03-24\"}, {\"name\": \"Shri Rama Navami\", \"date\": \"2026-03-26\"}, {\"name\": \"Swaminarayan Jayanti\", \"date\": \"2026-03-27\"}, {\"name\": \"Kamada Ekadashi\", \"date\": \"2026-03-29\"}, {\"name\": \"Karaga Festival\", \"date\": \"2026-04-02\"}, {\"name\": \"Hanuman Jayanti\", \"date\": \"2026-04-02\"}, {\"name\": \"Hanuman Janmotsava\", \"date\": \"2026-04-02\"}, {\"name\": \"Varuthini Ekadashi\", \"date\": \"2026-04-13\"}, {\"name\": \"Mesha Sankranti\", \"date\": \"2026-04-14\"}, {\"name\": \"Solar New Year\", \"date\": \"2026-04-14\"}, {\"name\": \"Parashurama Jayanti\", \"date\": \"2026-04-19\"}, {\"name\": \"Akshaya Tritiya\", \"date\": \"2026-04-19\"}, {\"name\": \"Ganga Saptami\", \"date\": \"2026-04-23\"}, {\"name\": \"Sita Navami\", \"date\": \"2026-04-25\"}, {\"name\": \"Mohini Ekadashi\", \"date\": \"2026-04-27\"}, {\"name\": \"Narasimha Jayanti\", \"date\": \"2026-04-30\"}, {\"name\": \"Buddha Purnima\", \"date\": \"2026-05-01\"}, {\"name\": \"Narada Jayanti\", \"date\": \"2026-05-02\"}, {\"name\": \"Apara Ekadashi\", \"date\": \"2026-05-13\"}, {\"name\": \"Vrishabha Sankranti\", \"date\": \"2026-05-15\"}, {\"name\": \"Vat Savitri Vrat\", \"date\": \"2026-05-16\"}, {\"name\": \"Shani Jayanti\", \"date\": \"2026-05-16\"}, {\"name\": \"Ganga Dussehra\", \"date\": \"2026-05-25\"}, {\"name\": \"Parama Ekadashi\", \"date\": \"2026-06-11\"}, {\"name\": \"Mithuna Sankranti\", \"date\": \"2026-06-15\"}, {\"name\": \"Nirjala Ekadashi\", \"date\": \"2026-06-25\"}, {\"name\": \"Vat Purnima Vrat\", \"date\": \"2026-06-29\"}, {\"name\": \"Yogini Ekadashi\", \"date\": \"2026-07-10\"}, {\"name\": \"Gauna Yogini Ekadashi\", \"date\": \"2026-07-11\"}, {\"name\": \"Karka Sankranti\", \"date\": \"2026-07-16\"}, {\"name\": \"Jagannath Rathyatra\", \"date\": \"2026-07-16\"}, {\"name\": \"Devshayani Ekadashi\", \"date\": \"2026-07-25\"}, {\"name\": \"Guru Purnima\", \"date\": \"2026-07-29\"}, {\"name\": \"Kamika Ekadashi\", \"date\": \"2026-08-09\"}, {\"name\": \"Surya Grahan *Purna\", \"date\": \"2026-08-12\"}, {\"name\": \"Hariyali Teej\", \"date\": \"2026-08-15\"}, {\"name\": \"Simha Sankranti\", \"date\": \"2026-08-17\"}, {\"name\": \"Nagara Panchami\", \"date\": \"2026-08-17\"}, {\"name\": \"Shravana Putrada Ekadashi\", \"date\": \"2026-08-23\"}, {\"name\": \"Onam\", \"date\": \"2026-08-26\"}, {\"name\": \"Varalakshmi Vrat\", \"date\": \"2026-08-28\"}, {\"name\": \"Chandra Grahan *Anshika\", \"date\": \"2026-08-28\"}, {\"name\": \"Raksha Bandhan\", \"date\": \"2026-08-28\"}, {\"name\": \"Rakhi\", \"date\": \"2026-08-28\"}, {\"name\": \"Gayatri Jayanti\", \"date\": \"2026-08-28\"}, {\"name\": \"Kajari Teej\", \"date\": \"2026-08-31\"}, {\"name\": \"Krishna Janmashtami\", \"date\": \"2026-09-04\"}, {\"name\": \"Aja Ekadashi\", \"date\": \"2026-09-07\"}, {\"name\": \"Hartalika Teej\", \"date\": \"2026-09-14\"}, {\"name\": \"Gowri Habba\", \"date\": \"2026-09-14\"}, "
}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.