Copy page
Copy page as Markdown for LLMs
Find Sankranti Festivals API
Track the twelve solar Sankranti transitions and the regional harvest and new-year festivals tied to them with the Find Sankranti Festivals API. For a given year and location, this API returns each Sankranti's date and exact transition moment, the auspicious Punya Kala and Maha Punya Kala windows, and associated festival images.
API Endpoint
POST https://astroapi-3.divineapi.com/indian-api/v1/sankranti-festivals
This endpoint provides Sankranti festival data for the given year and location, including each Sankranti's date and transition moment, the Punya Kala and Maha Punya Kala windows, 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 Sankranti 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 Sankranti festivals successfully
{
"success": 1,
"data": {
"year": 2027,
"makar_sankranti": {
"date": "2027-01-15",
"sankranti_moment": "2027-01-14 21:11:00",
"punya_kala": {
"start_time": "2027-01-15 07:15:02",
"end_time": "2027-01-15 17:45:59"
},
"maha_punya_kala": {
"start_time": "2027-01-15 07:15:02",
"end_time": "2027-01-15 09:00:02"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Makar%20Sankranti.png"
},
"kumbha_sankranti": {
"date": "2027-02-13",
"sankranti_moment": "2027-02-13 10:10:00",
"punya_kala": {
"start_time": "2027-02-13 07:01:30",
"end_time": "2027-02-13 10:10:00"
},
"maha_punya_kala": {
"start_time": "2027-02-13 08:17:00",
"end_time": "2027-02-13 10:10:00"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Kumbha%20Sankranti.png"
},
"meena_sankranti": {
"date": "2027-03-15",
"sankranti_moment": "2027-03-15 07:01:00",
"punya_kala": {
"start_time": "2027-03-15 07:01:00",
"end_time": "2027-03-15 13:25:00"
},
"maha_punya_kala": {
"start_time": "2027-03-15 07:01:00",
"end_time": "2027-03-15 09:01:00"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Meena%20Sankranti.png"
},
"mesha_sankranti": {
"date": "2027-04-14",
"sankranti_moment": "2027-04-14 15:29:00",
"punya_kala": {
"start_time": "2027-04-14 11:29:00",
"end_time": "2027-04-14 18:46:09"
},
"maha_punya_kala": {
"start_time": "2027-04-14 13:21:00",
"end_time": "2027-04-14 17:37:00"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Mesha%20Sankranti.png"
},
"vrishabha_sankranti": {
"date": "2027-05-15",
"sankranti_moment": "2027-05-15 12:20:00",
"punya_kala": {
"start_time": "2027-05-15 05:56:00",
"end_time": "2027-05-15 12:20:00"
},
"maha_punya_kala": {
"start_time": "2027-05-15 10:05:00",
"end_time": "2027-05-15 12:20:00"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vrishabha%20Sankranti.png"
},
"mithuna_sankranti": {
"date": "2027-06-15",
"sankranti_moment": "2027-06-15 18:56:00",
"punya_kala": {
"start_time": "2027-06-15 18:56:00",
"end_time": "2027-06-15 19:20:14"
},
"maha_punya_kala": {
"start_time": "2027-06-15 18:56:00",
"end_time": "2027-06-15 21:16:00"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Mithuna%20Sankranti.png"
},
"karka_sankranti": {
"date": "2027-07-17",
"sankranti_moment": "2027-07-17 05:49:00",
"punya_kala": {
"start_time": "2027-07-17 05:34:09",
"end_time": "2027-07-17 05:49:00"
},
"maha_punya_kala": {
"start_time": "2027-07-17 03:31:00",
"end_time": "2027-07-17 05:49:00"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Karka%20Sankranti.png"
},
"simha_sankranti": {
"date": "2027-08-17",
"sankranti_moment": "2027-08-17 14:14:00",
"punya_kala": {
"start_time": "2027-08-17 07:50:00",
"end_time": "2027-08-17 14:14:00"
},
"maha_punya_kala": {
"start_time": "2027-08-17 12:01:00",
"end_time": "2027-08-17 14:14:00"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Simha%20Sankranti.png"
},
"kanya_sankranti": {
"date": "2027-09-17",
"sankranti_moment": "2027-09-17 14:11:00",
"punya_kala": {
"start_time": "2027-09-17 14:11:00",
"end_time": "2027-09-17 18:24:18"
},
"maha_punya_kala": {
"start_time": "2027-09-17 14:11:00",
"end_time": "2027-09-17 16:14:00"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Kanya%20Sankranti.png"
},
"tula_sankranti": {
"date": "2027-10-18",
"sankranti_moment": "2027-10-18 02:09:00",
"punya_kala": {
"start_time": "2027-10-18 06:23:29",
"end_time": "2027-10-18 06:09:00"
},
"maha_punya_kala": {
"start_time": "2027-10-18 06:23:29",
"end_time": "2027-10-18 04:04:00"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Tula%20Sankranti.png"
},
"vrishchika_sankranti": {
"date": "2027-11-17",
"sankranti_moment": "2027-11-17 01:59:00",
"punya_kala": {
"start_time": "2027-11-17 06:44:56",
"end_time": "2027-11-17 13:08:56"
},
"maha_punya_kala": {
"start_time": "2027-11-17 06:44:56",
"end_time": "2027-11-17 08:32:56"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vrishchika%20Sankranti.png"
},
"dhanu_sankranti": {
"date": "2027-12-16",
"sankranti_moment": "2027-12-16 16:39:00",
"punya_kala": {
"start_time": "2027-12-16 16:39:00",
"end_time": "2027-12-16 17:26:28"
},
"maha_punya_kala": {
"start_time": "2027-12-16 16:39:00",
"end_time": "2027-12-16 18:22:00"
},
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Dhanu%20Sankranti.png"
},
"uttarayana": {
"date": "2027-01-15",
"sankranti_moment": "2027-01-14 21:11:00",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Uttarayana.png"
},
"lohri": {
"date": "2027-01-14",
"sankranti_moment": "2027-01-14 21:11:00",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Lohri.png"
},
"bhogi_pandigai": {
"date": "2027-01-14",
"sankranti_moment": "2027-01-14 21:11:00",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Bhogi%20Pandigai.png"
},
"pongal": {
"date": "2027-01-15",
"sankranti_moment": "2027-01-14 21:11:00",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Pongal.png"
},
"makara_vilakku": {
"date": "2027-01-15",
"sankranti_moment": "2027-01-14 21:11:00",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Makara%20Vilakku.png"
},
"magh_bihu": {
"date": "2027-01-15",
"sankranti_moment": "2027-01-14 21:11:00",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Magh%20Bihu.png"
},
"vaisakhi": {
"date": "2027-04-14",
"sankranti_moment": "2027-04-14 15:29:00",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vaisakhi.png"
},
"pana_sankranti": {
"date": "2027-04-14",
"sankranti_moment": "2027-04-14 15:29:00",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Pana%20Sankranti.png"
},
"vishu_kani": {
"date": "2027-04-15",
"sankranti_moment": "2027-04-14 15:29:00",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vishu%20Kani.png"
},
"pohela_boishakh": {
"date": "2027-04-15",
"sankranti_moment": "2027-04-14 15:29:00",
"bengali_era": 1434,
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Pohela%20Boishakh.png"
},
"puthandu": {
"date": "2027-04-14",
"sankranti_moment": "2027-04-14 15:29:00",
"tamil_shaka_samvata": 1949,
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Puthandu.png"
},
"malayalam_new_year": {
"date": "2027-08-18",
"sankranti_moment": "2027-08-17 14:14:00",
"malayalam_kollavarsham": 1203,
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Malayalam%20New%20Year.png"
},
"vishwakarma_puja": {
"date": "2027-09-17",
"sankranti_moment": "2027-09-17 14:11:00",
"image": "https://astroapi-6.divineapi.com/public/assets/vedic/festivals/images/main/Vishwakarma%20Puja.png"
}
}
}
Response Explanation
success
Indicates if the request was successful. Value 1 represents success.
data
Contains the year along with every Sankranti and related festival for that year.
year: The year for which the festivals are calculated.
date: The Gregorian date of the Sankranti or festival.
sankranti_moment: The exact date and time the Sun transits into the new zodiac sign.
punya_kala: The auspicious window (start and end time) for rituals, holy bathing and donations.
maha_punya_kala: The most auspicious sub-window (start and end time) within the Punya Kala.
image: URL of the corresponding festival image (useful for UI display).
Some regional new-year entries also include era fields such as bengali_era, tamil_shaka_samvata and malayalam_kollavarsham.
Festivals included in the response
Twelve solar Sankrantis (each with Punya Kala and Maha Punya Kala): Makar, Kumbha, Meena, Mesha, Vrishabha, Mithuna, Karka, Simha, Kanya, Tula, Vrishchika and Dhanu Sankranti.
Related festivals and regional new years: Uttarayana, Lohri, Bhogi Pandigai, Pongal, Makara Vilakku, Magh Bihu, Vaisakhi, Pana Sankranti, Vishu Kani, Pohela Boishakh, Puthandu, Malayalam New Year and Vishwakarma Puja.
Example Code Implementations
Below are example implementations in various programming environments.
cURL
curl --location 'https://astroapi-3.divineapi.com/indian-api/v1/sankranti-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/sankranti-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/sankranti-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/sankranti-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/sankranti-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.
A Sankranti marks the Sun's transition (Sankramana) into a new zodiac sign. There are twelve Sankrantis in a year, with Makar Sankranti in mid-January being the most widely celebrated.
The twelve zodiac Sankrantis include Punya Kala and Maha Punya Kala windows; related regional festivals such as Pongal, Lohri, Vaisakhi and Vishu return their date, moment and image.
Use the provided image URLs to visually represent festivals in your application interface.
Recommended for Panchang-based apps, event calendars, and festival scheduling dashboards.