Find Malayalam Festivals API

Get the major Kerala (Malayalam) festivals for any year with the Find Malayalam 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 Onam, Vishu, Thrissur Pooram, Attukal Pongala, Guruvayur Ekadashi and more.

API Endpoint

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

This endpoint provides Malayalam (Kerala) 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 Malayalam 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 Malayalam festivals successfully

{
    "success": 1,
    "data": {
        "year": 2026,
        "vishu_kani": {
            "date": "2026-04-15",
            "sankranti_moment": "2026-04-14 09:33:00",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vishu%20Kani.png"
        },
        "thrissur_pooram": {
            "date": "2026-04-27",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Thrissur%20Pooram.png"
        },
        "attukal_pongala": {
            "date": "2026-03-03",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Attukal%20Pongala.png"
        },
        "makara_vilakku": {
            "date": "2026-01-14",
            "sankranti_moment": "2026-01-14 15:08:00",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Makara%20Vilakku.png"
        },
        "malayalam_new_year": {
            "date": "2026-08-18",
            "sankranti_moment": "2026-08-17 07:59:00",
            "malayalam_kollavarsham": 1202,
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Malayalam%20New%20Year.png"
        },
        "ashtami_rohini": {
            "date": "2026-09-04",
            "nishita_muhurta": {
                "start_time": "2026-09-04 23:57:42",
                "end_time": "2026-09-05 00:43:10"
            },
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Ashtami%20Rohini.png"
        },
        "onam": {
            "date": "2026-08-26",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Onam.png"
        },
        "ganesha_chaturthi": {
            "date": "2026-09-14",
            "puja_muhurat": {
                "start_time": "2026-09-14 11:01:33",
                "end_time": "2026-09-14 13:31:33"
            },
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Ganesha%20Chaturthi.png"
        },
        "vidyarambham": {
            "date": "2026-10-21",
            "vijay_muhurta": {
                "start_time": "2026-10-21 13:58:52",
                "end_time": "2026-10-21 14:44:12"
            },
            "aparahna_puja_time": {
                "start_time": "2026-10-21 13:13:32",
                "end_time": "2026-10-21 15:29:32"
            },
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vidyarambham.png"
        },
        "mandalakala_begins": {
            "date": "2026-11-17",
            "sankranti_moment": "2026-11-16 19:44:00",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Mandalakala%20Begins.png"
        },
        "guruvayur_ekadashi": [
            {
                "smartas": {
                    "date": "2026-11-21",
                    "parana": {
                        "start_time": "2026-11-22 06:49:07",
                        "end_time": "2026-11-22 08:55:07"
                    },
                    "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Guruvayur%20Ekadashi.png"
                },
                "vaishnavas": {
                    "date": "2026-11-21",
                    "parana": {
                        "start_time": "2026-11-22 06:49:07",
                        "end_time": "2026-11-22 08:55:07"
                    },
                    "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Guruvayur%20Ekadashi.png"
                }
            }
        ],
        "mandala_pooja": {
            "date": "2026-12-27",
            "image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Mandala%20Pooja.png"
        }
    }
}

Response Explanation

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

data
Contains the year along with every Malayalam (Kerala) 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, 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:

nishita_muhurta: The midnight worship window (start and end), returned for Ashtami Rohini.

puja_muhurat: The worship window (start and end), for example Ganesha Chaturthi.

vijay_muhurta and aparahna_puja_time: The auspicious study-start and afternoon worship windows for Vidyarambham.

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

malayalam_kollavarsham: The Malayalam era (Kollavarsham) year, included with the Malayalam New Year.

Festivals included in the response

Vishu (Vishu Kani), Thrissur Pooram, Attukal Pongala, Makara Vilakku, Malayalam New Year, Ashtami Rohini, Onam, Ganesha Chaturthi, Vidyarambham, Mandalakala Begins, Guruvayur Ekadashi and Mandala Pooja.

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-3.divineapi.com/indian-api/v1/malayalam-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/malayalam-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/malayalam-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/malayalam-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/malayalam-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 Malayalam (Kerala) calendar. Coverage includes Onam, Vishu, Thrissur Pooram, Attukal Pongala, the Sabarimala season (Makara Vilakku, Mandalakala Begins and Mandala Pooja), Guruvayur Ekadashi and the Malayalam New Year.

Not every festival returns the same fields: some include a sankranti_moment, some include muhurta windows (nishita, puja, vijay, aparahna), Guruvayur Ekadashi includes parana timings under the smartas and vaishnavas traditions, and the Malayalam New Year includes the Kollavarsham era year.

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

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