/api/astro/gujarati_calendar/1 creditGujarati calendar
The Gujarati year for a given Gregorian year, resolved to the civil dates on which each observance is kept at the place you give. The Gujarati calendar is amanta luni-solar on the Vikrama Samvat era, whose new year falls at Bestu Varsh the day after Diwali rather than in spring, so the shape of the year differs from the Bengali and Assamese ones. The lunar observances are found by tithi and then resolved to the right day using the time of day each one requires, which matters more here than elsewhere: several Gujarati observances share a tithi but not a kaala, so Govardhan Puja and Bestu Varsh, or Kali Chaudas and Roop Chaudas, fall on the same tithi at different times of day. Send `year` with `latitude`, `longitude` and `timezone_as_float`. The response is `{year, events}` where events is a list of `{name, date}` in date order, `date` being a plain YYYY-MM-DD local civil date. The list is long: it runs to the monthly Sankashti Chaturthis, Ekadashis, Kalashtamis and Durgashtamis as well as the major festivals.
https://yogataraapi.prahlad.app/api/astro/gujarati_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/gujarati_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\": \"Lambodara Sankashta\", \"date\": \"2026-01-06\"}, {\"name\": \"Kalashtami\", \"date\": \"2026-01-10\"}, {\"name\": \"Masik Krishna Janmashtami\", \"date\": \"2026-01-10\"}, {\"name\": \"Shattila Ekadashi\", \"date\": \"2026-01-14\"}, {\"name\": \"Makara Sankranti\", \"date\": \"2026-01-14\"}, {\"name\": \"Uttarayana\", \"date\": \"2026-01-14\"}, {\"name\": \"Gauriganesha Chaturthi\", \"date\": \"2026-01-22\"}, {\"name\": \"Vasant Panchami\", \"date\": \"2026-01-23\"}, {\"name\": \"Masik Durgashtami\", \"date\": \"2026-01-26\"}, {\"name\": \"Jaya Ekadashi\", \"date\": \"2026-01-29\"}, {\"name\": \"Dwijapriya Sankashta\", \"date\": \"2026-02-05\"}, {\"name\": \"Kalashtami\", \"date\": \"2026-02-09\"}, {\"name\": \"Masik Krishna Janmashtami\", \"date\": \"2026-02-09\"}, {\"name\": \"Vijaya Ekadashi\", \"date\": \"2026-02-13\"}, {\"name\": \"Maha Shivaratri\", \"date\": \"2026-02-15\"}, {\"name\": \"Surya Grahan *Valayakara\", \"date\": \"2026-02-17\"}, {\"name\": \"Dhundhiraja Chaturthi\", \"date\": \"2026-02-21\"}, {\"name\": \"Masik Durgashtami\", \"date\": \"2026-02-24\"}, {\"name\": \"Amalaki Ekadashi\", \"date\": \"2026-02-27\"}, {\"name\": \"Chandra Grahan *Purna\", \"date\": \"2026-03-03\"}, {\"name\": \"Holi\", \"date\": \"2026-03-03\"}, {\"name\": \"Holika Dahan\", \"date\": \"2026-03-03\"}, {\"name\": \"Dhuleti\", \"date\": \"2026-03-04\"}, {\"name\": \"Bhalachandra Sankashta\", \"date\": \"2026-03-06\"}, {\"name\": \"Kalashtami\", \"date\": \"2026-03-11\"}, {\"name\": \"Masik Krishna Janmashtami\", \"date\": \"2026-03-11\"}, {\"name\": \"Papamochani Ekadashi\", \"date\": \"2026-03-15\"}, {\"name\": \"Gudi Padwa\", \"date\": \"2026-03-19\"}, {\"name\": \"Vasudeva Chaturthi\", \"date\": \"2026-03-22\"}, {\"name\": \"Masik Durgashtami\", \"date\": \"2026-03-26\"}, {\"name\": \"Rama Navami\", \"date\": \"2026-03-26\"}, {\"name\": \"Kamada Ekadashi\", \"date\": \"2026-03-29\"}, {\"name\": \"Hanuman Jayanti\", \"date\": \"2026-04-02\"}, {\"name\": \"Hanuman Janmotsava\", \"date\": \"2026-04-02\"}, {\"name\": \"Vikata Sankashta\", \"date\": \"2026-04-05\"}, {\"name\": \"Masik Krishna Janmashtami\", \"date\": \"2026-04-09\"}, {\"name\": \"Kalashtami\", \"date\": \"2026-04-10\"}, {\"name\": \"Varuthini Ekadashi\", \"date\": \"2026-04-13\"}, {\"name\": \"Parashurama Jayanti\", \"date\": \"2026-04-19\"}, {\"name\": \"Akha Trij\", \"date\": \"2026-04-19\"}, {\"name\": \"Sankarshana Chaturthi\", \"date\": \"2026-04-20\"}, {\"name\": \"Ganga Saptami\", \"date\": \"2026-04-23\"}, {\"name\": \"Masik Durgashtami\", \"date\": \"2026-04-24\"}, {\"name\": \"Sita Navami\", \"date\": \"2026-04-25\"}, {\"name\": \"Mohini Ekadashi\", \"date\": \"2026-04-27\"}, {\"name\": \"Nrisinha Jayanti\", \"date\": \"2026-04-30\"}, {\"name\": \"Kurma Jayanti\", \"date\": \"2026-05-01\"}, {\"name\": \"Narada Jayanti\", \"date\": \"2026-05-02\"}, {\"name\": \"Ekadanta Sankashta\", \"date\": \"2026-05-05\"}, {\"name\": \"Kalashtami\", \"date\": \"2026-05-09\"}, {\"name\": \"Masik Krishna Janmashtami\", \"date\": \"2026-05-09\"}, {\"name\": \"Apara Ekadashi\", \"date\": \"2026-05-13\"}, {\"name\": \"Shani Jayanti\", \"date\": \"2026-05-16\"}, {\"name\": \"Varada Chaturthi\", \"date\": \"2026-05-19\"}, {\"name\": \"Adhika Masik Durgashtami\", \"date\": \"2026-05-23\"}, {\"name\": \"Vibhuvana Sankashta\", \"date\": \"2026-06-03\"}, {\"name\": \"Adhika Kalashtami\", \"date\": \"2026-06-08\"}, {\"name\": \"Adhik Masik Krishna Janmashtami\", \"date\": \"2026-06-08\"}, {\"name\": \"Parama Ekadashi\", \"date\": \"2026-06-11\"}, {\"name\": \"Pradyumna Chaturthi\", \"date\": \"2026-06-18\"}, {\"name\": \"Masik Durgashtami\", \"date\": \"2026-06-22\"}, {\"name\": \"Nirjala Ekadashi\", \"date\": \"2026-06-25\"}, {\"name\": \"Krishnapingala Sankashta\", \"date\": \"2026-07-03\"}, {\"name\": \"Kalashtami\", \"date\": \"2026-07-07\"}, {\"name\": \"Masik Krishna Janmashtami\", \"date\": \"2026-07-07\"}, {\"name\": \"Yogini Ekadashi\", \"date\": \"2026-07-10\"}, {\"name\": \"Gauna Yogini Ekadashi\", \"date\": \"2026-07-11\"}, {\"name\": \"Vaishnava Yogini Ekadashi\", \"date\": \"2026-07-11\"}, {\"name\": \"Jagannath Rathyatra\", \"date\": \"2026-07-16\"}, {\"name\": \"Aniruddha Chaturthi\", \"date\": \"2026-07-17\"}, {\"name\": \"Masik Durgashtami\", \"date\": \"2026-07-21\"}, {\"name\": \"Devshayani Ekadashi\", \"date\": \"2026-07-25\"}, {\"name\": \"Gauri Vrat Begins\", \"date\": \"2026-07-25\"}, {\"name\": \"Jayaparvati Vrat Begins\", \"date\": \"2026-07-27\"}, {\"name\": \"Kokila Vrat\", \"date\": \"2026-07-28\""
}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.