Griha Pravesh (House Entering) Muhurat API
The Griha Pravesh (House Entering) Muhurat API is part of the Muhurat Finder suite and returns auspicious dates and time windows for entering or inaugurating a new home 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 griha pravesh 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/house-entering
This endpoint returns auspicious griha pravesh (house entering) 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 Griha Pravesh muhurats fetched successfully
{
"success": 1,
"data": {
"muhurat_type": "house-entering",
"month": 5,
"year": 2023,
"month_notes": [
{
"reason": "Guru Tara Asta (with 3-day Vriddha/Bala Tara)",
"from": "2023-05-01",
"to": "2023-05-07"
}
],
"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": "false",
"muhurats": []
},
{
"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": "false",
"muhurats": []
},
{
"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": "false",
"muhurats": []
},
{
"date": "2023-05-11",
"weekday": "Thursday",
"sunrise": "2023-05-11 05:33",
"is_muhurat": "true",
"muhurats": [
{
"muhurat_start": "2023-05-11 11:27",
"muhurat_end": "2023-05-11 14:36",
"duration_minutes": 189,
"continues_from_previous_day": "false",
"continues_next_day": "false",
"nakshatras": [
"Uttara Ashadha"
],
"tithis": [
"Krishna Saptami"
]
}
]
},
{
"date": "2023-05-12",
"weekday": "Friday",
"sunrise": "2023-05-12 05:32",
"is_muhurat": "false",
"muhurats": []
},
{
"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": "true",
"muhurats": [
{
"muhurat_start": "2023-05-15 09:08",
"muhurat_end": "2023-05-16 01:03",
"duration_minutes": 955,
"continues_from_previous_day": "false",
"continues_next_day": "false",
"nakshatras": [
"Uttara Bhadrapada"
],
"tithis": [
"Krishna Ekadashi"
]
}
]
},
{
"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": "false",
"muhurats": []
},
{
"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": "true",
"muhurats": [
{
"muhurat_start": "2023-05-20 21:31",
"muhurat_end": "2023-05-21 05:27",
"duration_minutes": 476,
"continues_from_previous_day": "false",
"continues_next_day": "false",
"nakshatras": [
"Rohini"
],
"tithis": [
"Shukla Dwitiya"
]
}
]
},
{
"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": "true",
"muhurats": [
{
"muhurat_start": "2023-05-22 05:27",
"muhurat_end": "2023-05-22 10:36",
"duration_minutes": 310,
"continues_from_previous_day": "false",
"continues_next_day": "false",
"nakshatras": [
"Mrigashira"
],
"tithis": [
"Shukla Tritiya"
]
}
]
},
{
"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": "true",
"muhurats": [
{
"muhurat_start": "2023-05-29 11:49",
"muhurat_end": "2023-05-30 04:28",
"duration_minutes": 999,
"continues_from_previous_day": "false",
"continues_next_day": "false",
"nakshatras": [
"Uttara Phalguni"
],
"tithis": [
"Shukla Dashami"
]
}
]
},
{
"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": "true",
"muhurats": [
{
"muhurat_start": "2023-05-31 06:00",
"muhurat_end": "2023-05-31 13:46",
"duration_minutes": 466,
"continues_from_previous_day": "false",
"continues_next_day": "false",
"nakshatras": [
"Chitra"
],
"tithis": [
"Shukla Ekadashi"
]
}
]
}
]
}
}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/house-entering' \
--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/house-entering',
'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/house-entering",
"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/house-entering"
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.