Foundation Laying (Bhoomi Pujan) Muhurat API
The Foundation Laying (Bhoomi Pujan) Muhurat API is part of the Muhurat Finder suite and returns auspicious dates and time windows for laying a foundation or performing bhoomi pujan in a given month and year, as per Vedic astrology. It provides notable favorable windows for the month and a day-by-day list of foundation laying muhurats.
Supported Language Codes
This API supports multiple languages. You can get the response in a different language by passing the lan field in the request body.
Reference Article:
https://support.divineapi.com/general-api-support/translating-an-indian-vedic-apis-into-a-different-language
| Code | Language |
|---|---|
| en | English |
| hi | Hindi |
| bn | Bengali |
| ma | Marathi |
| tm | Tamil |
| tl | Telugu |
| ml | Malayalam |
| kn | Kannada |
Guide: If lan is not sent, the default response language is en.
API Endpoint
POST https://astroapi-3.divineapi.com/indian-api/v1/muhurat/foundation-laying
This endpoint returns auspicious foundation laying (bhoomi pujan) dates and time windows for the given month and year.
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. |
| month | Integer | Yes | Month of Panchang, e.g. 05. |
| year | Integer | Yes | Year of Panchang, e.g. 2023. |
| place | String | No | Place name, e.g. New Delhi. |
| lat | Float | Yes | Latitude, e.g. 28.6139. |
| lon | Float | Yes | Longitude, e.g. 77.2090. |
| tzone | Float | Yes | Timezone, e.g. 5.5. See: https://developers.divineapi.com/divine-api/understanding-time-zones-a-comprehensive-guide |
| lan | String | No | Language code as per supported list. Default is en. |
200: OK Foundation laying muhurats fetched successfully
{
"success": 1,
"data": {
"muhurat_type": "foundation-laying",
"month": 5,
"year": 2023,
"month_notes": [
{
"reason": "Panchaka (Moon in Aquarius/Pisces)",
"from": "2023-05-13",
"to": "2023-05-17"
},
{
"reason": "Prohibited lunar month (Jyeshtha)",
"from": "2023-05-19",
"to": "2023-05-31"
}
],
"dates": [
{
"date": "2023-05-01",
"weekday": "Monday",
"sunrise": "2023-05-01 05:40",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-02",
"weekday": "Tuesday",
"sunrise": "2023-05-02 05:40",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-03",
"weekday": "Wednesday",
"sunrise": "2023-05-03 05:39",
"is_muhurat": "true",
"muhurats": [
{
"muhurat_start": "2023-05-03 05:39",
"muhurat_end": "2023-05-03 11:26",
"duration_minutes": 348,
"continues_from_previous_day": "false",
"continues_next_day": "false",
"nakshatras": [
"Hasta"
],
"tithis": [
"Shukla Trayodashi"
]
}
]
},
{
"date": "2023-05-04",
"weekday": "Thursday",
"sunrise": "2023-05-04 05:38",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-05",
"weekday": "Friday",
"sunrise": "2023-05-05 05:37",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-06",
"weekday": "Saturday",
"sunrise": "2023-05-06 05:36",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-07",
"weekday": "Sunday",
"sunrise": "2023-05-07 05:36",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-08",
"weekday": "Monday",
"sunrise": "2023-05-08 05:35",
"is_muhurat": "true",
"muhurats": [
{
"muhurat_start": "2023-05-08 05:35",
"muhurat_end": "2023-05-08 07:16",
"duration_minutes": 101,
"continues_from_previous_day": "false",
"continues_next_day": "false",
"nakshatras": [
"Jyeshtha"
],
"tithis": [
"Krishna Tritiya"
]
}
]
},
{
"date": "2023-05-09",
"weekday": "Tuesday",
"sunrise": "2023-05-09 05:34",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-10",
"weekday": "Wednesday",
"sunrise": "2023-05-10 05:33",
"is_muhurat": "true",
"muhurats": [
{
"muhurat_start": "2023-05-10 16:12",
"muhurat_end": "2023-05-11 05:33",
"duration_minutes": 801,
"continues_from_previous_day": "false",
"continues_next_day": "true",
"nakshatras": [
"Uttara Ashadha"
],
"tithis": [
"Krishna Shashthi"
]
}
]
},
{
"date": "2023-05-11",
"weekday": "Thursday",
"sunrise": "2023-05-11 05:33",
"is_muhurat": "true",
"muhurats": [
{
"muhurat_start": "2023-05-11 05:33",
"muhurat_end": "2023-05-11 11:27",
"duration_minutes": 355,
"continues_from_previous_day": "true",
"continues_next_day": "false",
"nakshatras": [
"Uttara Ashadha"
],
"tithis": [
"Krishna Shashthi"
]
},
{
"muhurat_start": "2023-05-11 22:17",
"muhurat_end": "2023-05-12 05:32",
"duration_minutes": 436,
"continues_from_previous_day": "false",
"continues_next_day": "true",
"nakshatras": [
"Shravana"
],
"tithis": [
"Krishna Saptami"
]
}
]
},
{
"date": "2023-05-12",
"weekday": "Friday",
"sunrise": "2023-05-12 05:32",
"is_muhurat": "true",
"muhurats": [
{
"muhurat_start": "2023-05-12 05:32",
"muhurat_end": "2023-05-12 09:07",
"duration_minutes": 214,
"continues_from_previous_day": "true",
"continues_next_day": "false",
"nakshatras": [
"Shravana"
],
"tithis": [
"Krishna Saptami"
]
}
]
},
{
"date": "2023-05-13",
"weekday": "Saturday",
"sunrise": "2023-05-13 05:32",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-14",
"weekday": "Sunday",
"sunrise": "2023-05-14 05:31",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-15",
"weekday": "Monday",
"sunrise": "2023-05-15 05:30",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-16",
"weekday": "Tuesday",
"sunrise": "2023-05-16 05:30",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-17",
"weekday": "Wednesday",
"sunrise": "2023-05-17 05:30",
"is_muhurat": "true",
"muhurats": [
{
"muhurat_start": "2023-05-17 07:38",
"muhurat_end": "2023-05-17 12:18",
"duration_minutes": 279,
"continues_from_previous_day": "false",
"continues_next_day": "false",
"nakshatras": [
"Ashwini"
],
"tithis": [
"Krishna Trayodashi"
]
},
{
"muhurat_start": "2023-05-17 13:59",
"muhurat_end": "2023-05-17 22:29",
"duration_minutes": 509,
"continues_from_previous_day": "false",
"continues_next_day": "false",
"nakshatras": [
"Ashwini"
],
"tithis": [
"Krishna Trayodashi"
]
}
]
},
{
"date": "2023-05-18",
"weekday": "Thursday",
"sunrise": "2023-05-18 05:29",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-19",
"weekday": "Friday",
"sunrise": "2023-05-19 05:28",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-20",
"weekday": "Saturday",
"sunrise": "2023-05-20 05:28",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-21",
"weekday": "Sunday",
"sunrise": "2023-05-21 05:27",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-22",
"weekday": "Monday",
"sunrise": "2023-05-22 05:27",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-23",
"weekday": "Tuesday",
"sunrise": "2023-05-23 05:26",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-24",
"weekday": "Wednesday",
"sunrise": "2023-05-24 05:26",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-25",
"weekday": "Thursday",
"sunrise": "2023-05-25 05:25",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-26",
"weekday": "Friday",
"sunrise": "2023-05-26 05:25",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-27",
"weekday": "Saturday",
"sunrise": "2023-05-27 05:25",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-28",
"weekday": "Sunday",
"sunrise": "2023-05-28 05:24",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-29",
"weekday": "Monday",
"sunrise": "2023-05-29 05:24",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-30",
"weekday": "Tuesday",
"sunrise": "2023-05-30 05:24",
"is_muhurat": "false",
"muhurats": []
},
{
"date": "2023-05-31",
"weekday": "Wednesday",
"sunrise": "2023-05-31 05:24",
"is_muhurat": "false",
"muhurats": []
}
]
}
}Notes on Response Fields
muhurat_type: The muhurat category requested (for example marriage).
month and year: The month and year the auspicious dates were calculated for.
month_notes: An array of notable windows in the month. Each entry has a reason, a from date and a to date.
dates: A day-by-day list for the month. Each entry contains the date, weekday, sunrise, an is_muhurat flag showing whether the day is auspicious, and a muhurats list of favorable time windows on that day.
Example Code Implementations
Below are example implementations in various programming environments.
cURL
curl --location 'https://astroapi-3.divineapi.com/indian-api/v1/muhurat/foundation-laying' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'place="New Delhi"' \
--form 'lat="28.6139"' \
--form 'lon="77.2090"' \
--form 'tzone="5.5"' \
--form 'lan="en"'Node.js
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://astroapi-3.divineapi.com/indian-api/v1/muhurat/foundation-laying',
'headers': {
'Authorization': 'Bearer {Your Auth Token}'
},
formData: {
'api_key': '{Your API Key}',
'month': '05',
'year': '2023',
'Place': 'New Delhi',
'lat': '28.6139',
'lon': '77.2090',
'tzone': '5.5',
'lan': 'en'
}
};
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("month", "05");
form.append("year", "2023");
form.append("Place", "New Delhi");
form.append("lat", "28.6139");
form.append("lon", "77.2090");
form.append("tzone", "5.5");
form.append("lan", "en");
var settings = {
"url": "https://astroapi-3.divineapi.com/indian-api/v1/muhurat/foundation-laying",
"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);
});Python
import requests
url = "https://astroapi-3.divineapi.com/indian-api/v1/muhurat/foundation-laying"
payload = {'api_key': '{Your API Key}',
'month': '05',
'year': '2023',
'Place': 'New Delhi',
'lat': '28.6139',
'lon': '77.2090',
'tzone': '5.5',
'lan': 'en'}
headers = {
'Authorization': 'Bearer {Your Auth Token}'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)Best Practices
Always send both Authorization: Bearer {Your Auth Token} and api_key in every request.
Make sure lat, lon, and tzone match the user’s actual location, since auspicious timings are location-specific.
Some fields may return empty arrays ([]) for certain dates; handle this gracefully in your UI.
Always use HTTPS for secure communication.
Use the lan parameter to localize the auspicious timing labels for your target audience.