Find Tamil Festivals API

Get the major Tamil festivals for any year with the Find Tamil Festivals API. For a given year and location, this API returns each festival's Gregorian date, the relevant auspicious muhurta or parana timings where applicable, and associated festival images, covering Thai Pongal, Puthandu, Karthigai Deepam, Thaipusam, Vaikuntha Ekadashi and more.

API Endpoint

POST https://astroapi-3.divineapi.com/indian-api/v1/tamil-festivals

This endpoint provides Tamil festival data for the given year and location, including each festival's date, any solar-transition moment or auspicious muhurta and parana timings that apply, and festival images.

Headers

Name	Type	Description
Authorization*	String	Your API Access Token. Example: `Bearer {token}`

Request Body

Name	Type	Required	Description
api_key	String	Yes	Your API key.
year	Integer	Yes	The year for which you want to fetch Tamil festival data. Example: `2027`.
place	String	No	The name of the place. Example: `New Delhi`.
lat	Float	Yes	Latitude of the location. Example: `28.6139`.
lon	Float	Yes	Longitude of the location. Example: `77.2090`.
tzone	Float	Yes	Timezone offset for the location. Example: `5.5`. See: Timezone Guide

200: OK Fetched Tamil festivals successfully

{
    "success": 1,
    "data": {
        "year": 2026,
        "thai_pongal": {
            "date": "2026-01-14",
            "sankranti_moment": "2026-01-14 15:08:00",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Thai%20Pongal.png"
        },
        "puthandu": {
            "date": "2026-04-14",
            "sankranti_moment": "2026-04-14 09:33:00",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Puthandu.png"
        },
        "tamil_deepavali": {
            "date": "2026-11-08",
            "deepavali_muhurta": {
                "start_time": "2026-11-08 05:17:08",
                "end_time": "2026-11-08 06:38:08"
            },
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Tamil%20Deepavali.png"
        },
        "kedar_gauri_vrat": {
            "date": "2026-11-08",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Kedar%20Gauri%20Vrat.png"
        },
        "karthigai_deepam": {
            "date": "2026-11-24",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Karthigai%20Deepam.png"
        },
        "soorasamharam": {
            "date": "2026-11-15",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Soorasamharam.png"
        },
        "panguni_uthiram": {
            "date": "2026-04-01",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Panguni%20Uthiram.png"
        },
        "vaikuntha_ekadashi": {
            "smartas": {
                "date": "2026-12-20",
                "parana": {
                    "start_time": "2026-12-21 07:09:30",
                    "end_time": "2026-12-21 09:12:30"
                },
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vaikuntha%20Ekadashi.png"
            },
            "vaishnavas": {
                "date": "2026-12-20",
                "parana": {
                    "start_time": "2026-12-21 07:09:30",
                    "end_time": "2026-12-21 09:12:30"
                },
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vaikuntha%20Ekadashi.png"
            }
        },
        "vaikasi_visakam": {
            "date": "2026-05-30",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vaikasi%20Visakam.png"
        },
        "thai_pusam": {
            "date": "2026-02-01",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Thai%20Pusam.png"
        },
        "karadaiyan_nombu": {
            "date": "2026-03-15",
            "sankranti_moment": "2026-03-15 01:04:00",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Karadaiyan%20Nombu.png"
        },
        "masi_magam": {
            "date": "2026-03-03",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Masi%20Magam.png"
        },
        "hanumath_jayanthi": [],
        "arudra_darshan": [
            {
                "date": "2026-01-03",
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Arudra%20Darshan.png"
            },
            {
                "date": "2026-12-24",
                "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Arudra%20Darshan.png"
            }
        ],
        "avani_avittam": {
            "date": "2026-08-28",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Avani%20Avittam.png"
        },
        "chitra_pournami": {
            "date": "2026-05-01",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Chitra%20Pournami.png"
        }
    }
}

Response Explanation

success
Indicates if the request was successful. Value 1 represents success.

data
Contains the year along with every Tamil festival for that year.

year: The year for which the festivals are calculated.

date: The Gregorian date of the festival.

sankranti_moment: For solar-transition based festivals such as Thai Pongal and Puthandu, the exact date and time the Sun enters the new sign.

image: URL of the corresponding festival image (useful for UI display).

Depending on the festival, additional timing fields are included:

deepavali_muhurta: The auspicious window (start and end) for Tamil Deepavali.

parana: For Vaikuntha Ekadashi, the fast-breaking window, returned under both smartas and vaishnavas traditions.

Some festivals return an array of entries (for example Arudra Darshan, which can occur twice in a year); a festival that does not fall in the requested year is returned as an empty array.

Festivals included in the response

Thai Pongal, Puthandu (Tamil New Year), Tamil Deepavali, Kedar Gauri Vrat, Karthigai Deepam, Soorasamharam, Panguni Uthiram, Vaikuntha Ekadashi, Vaikasi Visakam, Thaipusam, Karadaiyan Nombu, Masi Magam, Hanumath Jayanthi, Arudra Darshan, Avani Avittam and Chitra Pournami.

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-3.divineapi.com/indian-api/v1/tamil-festivals' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'year="2027"' \
--form 'place="New Delhi"' \
--form 'lat="28.6139"' \
--form 'lon="77.2090"' \
--form 'tzone="5.5"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-3.divineapi.com/indian-api/v1/tamil-festivals',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'year': '2027',
    'Place': 'New Delhi',
    'lat': '28.6139',
    'lon': '77.2090',
    'tzone': '5.5'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

JavaScript jQuery AJAX

var form = new FormData();
form.append("api_key", "{Your API Key}");
form.append("year", "2027");
form.append("Place", "New Delhi");
form.append("lat", "28.6139");
form.append("lon", "77.2090");
form.append("tzone", "5.5");

var settings = {
  "url": "https://astroapi-3.divineapi.com/indian-api/v1/tamil-festivals",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer {Your Auth Token}"
  },
  "processData": false,
  "mimeType": "multipart/form-data",
  "contentType": false,
  "data": form
};

$.ajax(settings).done(function (response) {
  console.log(response);
});import requests

url = "https://astroapi-3.divineapi.com/indian-api/v1/tamil-festivals"

payload = {'api_key': '{Your API Key}',
'year': '2027',
'Place': 'New Delhi',
'lat': '28.6139',
'lon': '77.2090',
'tzone': '5.5'}
files=[

]
headers = {
  'Authorization': 'Bearer Bearer {Your Auth Token}'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

Python

import requests

url = "https://astroapi-3.divineapi.com/indian-api/v1/tamil-festivals"

payload = {'api_key': '{Your API Key}',
'year': '2027',
'Place': 'New Delhi',
'lat': '28.6139',
'lon': '77.2090',
'tzone': '5.5'}

headers = {
  'Authorization': 'Bearer {Your Auth Token}'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Implementation Notes

Always include both api_key and Authorization headers.

These are the principal festivals of the Tamil calendar. Coverage includes Thai Pongal, Puthandu (Tamil New Year), Karthigai Deepam, Thaipusam, Panguni Uthiram, Vaikuntha Ekadashi, Masi Magam and Chitra Pournami.

Not every festival returns the same fields: some include a sankranti_moment, Tamil Deepavali includes a deepavali_muhurta, Vaikuntha Ekadashi includes parana timings under the smartas and vaishnavas traditions, and some festivals such as Arudra Darshan return an array of dates while a festival that does not fall in the requested year returns an empty array.

Use the provided image URLs to visually represent festivals in your application interface.

Recommended for Panchang-based apps, event calendars, and festival scheduling dashboards.