/api/astro/tamil_calendar/1 creditTamil calendar
The Tamil calendar is solar rather than lunar, and that is what separates it from most of the other regional calendars here. A month begins the moment the Sun enters a new sidereal sign, so the twelve months (Chithirai, Vaikasi, Aani, Aadi, Aavani, Purattasi, Aippasi, Karthigai, Margazhi, Thai, Maasi and Panguni) follow the Sun's position and start on roughly the same Gregorian dates each year, with Chithirai opening the year around 14 April. Day one of a month is fixed by the sunset rule: if the Sun's ingress falls between sunrise and sunset, that civil day is day one, and if it falls after sunset the following day is. The Telugu, Marathi, Gujarati and Kannada calendars, by contrast, count months from a new or full Moon. Post a `year` together with `latitude`, `longitude` and `timezone_as_float`. The sunrise and sunset that resolve each observance are computed for those coordinates, so an event can shift by a day if you change location. The response is `{year, events}`, where each event is `{name, date, tamil_month, tamil_day}` — the Gregorian date plus the position within the Tamil month — covering the whole Gregorian year. Pongal, Puthandu, Thai Pusam, Masi Magam, Panguni Uthiram, Aadi Perukku, Karadaiyan Nombu, Ayutha Poojai and the rest appear under their Tamil names. A number of these festivals are the same lunar tithi the main Hindu festival engine computes, looked up under a Tamil name and then resolved to its own observance rule (sunrise, madhyahna, aparahna, nishita, pradosha or purvahna). Those come from the precomputed festival table and so limit this endpoint to the years 2006-2046. A few entries are deliberately left out rather than guessed, among them Agni Nakshatram, the three Veda-specific Avani Avittam dates, Gayathri Japam and Agastya Arghya.
https://yogataraapi.prahlad.app/api/astro/tamil_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/tamil_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": "Arudra Darshan",
"date": "2026-01-03",
"tamil_month": "Margazhi",
"tamil_day": 19
},
{
"name": "Bhogi Pandigai",
"date": "2026-01-13",
"tamil_month": "Margazhi",
"tamil_day": 29
},
{
"name": "Pongal",
"date": "2026-01-14",
"tamil_month": "Thai",
"tamil_day": 1
},
{
"name": "Mattu Pongal",
"date": "2026-01-15",
"tamil_month": "Thai",
"tamil_day": 2
},
{
"name": "Thai Amavasai",
"date": "2026-01-18",
"tamil_month": "Thai",
"tamil_day": 5
},
{
"name": "Ratha Sapthami",
"date": "2026-01-25",
"tamil_month": "Thai",
"tamil_day": 12
},
{
"name": "Thai Pusam",
"date": "2026-02-01",
"tamil_month": "Thai",
"tamil_day": 19
},
{
"name": "Shivaratri",
"date": "2026-02-15",
"tamil_month": "Maasi",
"tamil_day": 3
},
{
"name": "Masi Magam",
"date": "2026-03-03",
"tamil_month": "Maasi",
"tamil_day": 19
},
{
"name": "Karadaiyan Nombu",
"date": "2026-03-14",
"tamil_month": "Maasi",
"tamil_day": 30
},
{
"name": "Ugadi - Telugu New Year",
"date": "2026-03-19",
"tamil_month": "Panguni",
"tamil_day": 5
},
{
"name": "Rama Navami *Smarta",
"date": "2026-03-26",
"tamil_month": "Panguni",
"tamil_day": 12
},
{
"name": "Panguni Uthiram",
"date": "2026-04-01",
"tamil_month": "Panguni",
"tamil_day": 18
},
{
"name": "Puthandu",
"date": "2026-04-14",
"tamil_month": "Chithirai",
"tamil_day": 1
},
{
"name": "Vishu",
"date": "2026-04-15",
"tamil_month": "Chithirai",
"tamil_day": 2
},
{
"name": "Akshaya Thiruthiyai",
"date": "2026-04-19",
"tamil_month": "Chithirai",
"tamil_day": 6
},
{
"name": "Sankara Jayanthi",
"date": "2026-04-21",
"tamil_month": "Chithirai",
"tamil_day": 8
},
{
"name": "Ramanuja Jayanthi",
"date": "2026-04-22",
"tamil_month": "Chithirai",
"tamil_day": 9
},
{
"name": "Chitra Pournami",
"date": "2026-05-01",
"tamil_month": "Chithirai",
"tamil_day": 18
},
{
"name": "Vaikasi Visakam",
"date": "2026-05-30",
"tamil_month": "Vaikasi",
"tamil_day": 16
},
{
"name": "Aadi Perukku",
"date": "2026-08-03",
"tamil_month": "Aadi",
"tamil_day": 18
},
{
"name": "Aadi Amavasai",
"date": "2026-08-12",
"tamil_month": "Aadi",
"tamil_day": 27
},
{
"name": "Andal Jayanthi",
"date": "2026-08-14",
"tamil_month": "Aadi",
"tamil_day": 29
},
{
"name": "Gokulastami",
"date": "2026-09-04",
"tamil_month": "Aavani",
"tamil_day": 19
},
{
"name": "Astami Rohini",
"date": "2026-09-04",
"tamil_month": "Aavani",
"tamil_day": 19
},
{
"name": "Vinayagar Chathurthi",
"date": "2026-09-14",
"tamil_month": "Aavani",
"tamil_day": 29
},
{
"name": "Mahalaya Amavasai",
"date": "2026-10-10",
"tamil_month": "Purattasi",
"tamil_day": 24
},
{
"name": "Navarathiri",
"date": "2026-10-11",
"tamil_month": "Purattasi",
"tamil_day": 25
},
{
"name": "Ayutha Poojai",
"date": "2026-10-20",
"tamil_month": "Aippasi",
"tamil_day": 3
},
{
"name": "Saraswati Poojai",
"date": "2026-10-20",
"tamil_month": "Aippasi",
"tamil_day": 3
},
{
"name": "Vijaya Dashami",
"date": "2026-10-20",
"tamil_month": "Aippasi",
"tamil_day": 3
},
{
"name": "Vidyarambham",
"date": "2026-10-21",
"tamil_month": "Aippasi",
"tamil_day": 4
},
{
"name": "Lakshmi Puja",
"date": "2026-11-08",
"tamil_month": "Aippasi",
"tamil_day": 22
},
{
"name": "Kedara Gowri Vratham",
"date": "2026-11-08",
"tamil_month": "Aippasi",
"tamil_day": 22
},
{
"name": "Deepavali",
"date": "2026-11-08",
"tamil_month": "Aippasi",
"tamil_day": 22
},
{
"name": "Karthigai Deepam",
"date": "2026-11-24",
"tamil_month": "Karthigai",
"tamil_day": 8
},
{
"name": "Subrahmanya Sashti",
"date": "2026-12-15",
"tamil_month": "Karthigai",
"tamil_day": 29
},
{
"name": "Vaikuntha Ekadashi",
"date": "2026-12-20",
"tamil_month": "Margazhi",
"tamil_day": 5
},
{
"name": "Arudra Darshan",
"date": "2026-12-24",
"tamil_month": "Margazhi",
"tamil_day": 9
}
]
},
"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.