Copy page

Copy page as Markdown for LLMs

View as Markdown

View this page as plain text


Open in ChatGPT

Ask ChatGPT about this page

Open in Claude

Ask Claude about this page

Do Ghati Muhurat API

The Do Ghati Muhurat API is part of the Muhurat Finder suite and returns the Do Ghati muhurats for a specific date, as per Vedic astrology. For the requested day it divides the day and night into muhurat periods and marks which are auspicious, with precise start and end times for each.


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

CodeLanguage
enEnglish
hiHindi
bnBengali
maMarathi
tmTamil
tlTelugu
mlMalayalam
knKannada

Guide: If lan is not sent, the default response language is en.


API Endpoint

POST https://astroapi-3.divineapi.com/indian-api/v1/muhurat/do-ghati

This endpoint returns the Do Ghati muhurats for the given date, split across the day and the night.


Headers

NameTypeDescription
AuthorizationStringYour API Access Token. Example: Bearer {token}

Request Body

NameTypeRequiredDescription
api_keyStringYesYour API key.
dayIntegerYesDay of Panchang, e.g. 24.
monthIntegerYesMonth of Panchang, e.g. 05.
yearIntegerYesYear of Panchang, e.g. 2023.
placeStringNoPlace name, e.g. New Delhi.
latFloatYesLatitude, e.g. 28.6139.
lonFloatYesLongitude, e.g. 77.2090.
tzoneFloatYesTimezone, e.g. 5.5. See: https://developers.divineapi.com/divine-api/understanding-time-zones-a-comprehensive-guide
lanStringNoLanguage code as per supported list. Default is en.

200: OK Do Ghati muhurats fetched successfully

{
    "success": 1,
    "data": {
        "muhurat_type": "do-ghati",
        "date": "2023-05-24",
        "weekday": "Wednesday",
        "sunrise": "2023-05-24 05:26",
        "sunset": "2023-05-24 19:09",
        "day_muhurats": [
            {
                "position": 1,
                "period": "Pratah",
                "special": null,
                "name": "Rudra",
                "is_auspicious": "false",
                "muhurat_start": "2023-05-24 05:26",
                "muhurat_end": "2023-05-24 06:21",
                "duration_minutes": 55
            },
            {
                "position": 2,
                "period": "Pratah",
                "special": null,
                "name": "Uraga",
                "is_auspicious": "false",
                "muhurat_start": "2023-05-24 06:21",
                "muhurat_end": "2023-05-24 07:16",
                "duration_minutes": 55
            },
            {
                "position": 3,
                "period": "Pratah",
                "special": null,
                "name": "Mitra",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-24 07:16",
                "muhurat_end": "2023-05-24 08:11",
                "duration_minutes": 55
            },
            {
                "position": 4,
                "period": "Sangava",
                "special": null,
                "name": "Pitara",
                "is_auspicious": "false",
                "muhurat_start": "2023-05-24 08:11",
                "muhurat_end": "2023-05-24 09:05",
                "duration_minutes": 55
            },
            {
                "position": 5,
                "period": "Sangava",
                "special": null,
                "name": "Vasu",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-24 09:05",
                "muhurat_end": "2023-05-24 10:00",
                "duration_minutes": 55
            },
            {
                "position": 6,
                "period": "Sangava",
                "special": null,
                "name": "Ambu",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-24 10:00",
                "muhurat_end": "2023-05-24 10:55",
                "duration_minutes": 55
            },
            {
                "position": 7,
                "period": "Madhyahna",
                "special": null,
                "name": "Vishwedeva",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-24 10:55",
                "muhurat_end": "2023-05-24 11:50",
                "duration_minutes": 55
            },
            {
                "position": 8,
                "period": "Madhyahna",
                "special": "Abhijit Muhurat",
                "name": "Vidhi",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-24 11:50",
                "muhurat_end": "2023-05-24 12:45",
                "duration_minutes": 55
            },
            {
                "position": 9,
                "period": "Madhyahna",
                "special": null,
                "name": "Brahma",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-24 12:45",
                "muhurat_end": "2023-05-24 13:40",
                "duration_minutes": 55
            },
            {
                "position": 10,
                "period": "Aparahna",
                "special": null,
                "name": "Indra",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-24 13:40",
                "muhurat_end": "2023-05-24 14:35",
                "duration_minutes": 55
            },
            {
                "position": 11,
                "period": "Aparahna",
                "special": "Vijay Muhurat",
                "name": "Indragni",
                "is_auspicious": "false",
                "muhurat_start": "2023-05-24 14:35",
                "muhurat_end": "2023-05-24 15:30",
                "duration_minutes": 55
            },
            {
                "position": 12,
                "period": "Aparahna",
                "special": null,
                "name": "Daitya",
                "is_auspicious": "false",
                "muhurat_start": "2023-05-24 15:30",
                "muhurat_end": "2023-05-24 16:25",
                "duration_minutes": 55
            },
            {
                "position": 13,
                "period": "Sayahna",
                "special": null,
                "name": "Varuna",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-24 16:25",
                "muhurat_end": "2023-05-24 17:20",
                "duration_minutes": 55
            },
            {
                "position": 14,
                "period": "Sayahna",
                "special": null,
                "name": "Aryama",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-24 17:20",
                "muhurat_end": "2023-05-24 18:15",
                "duration_minutes": 55
            },
            {
                "position": 15,
                "period": "Sayahna",
                "special": null,
                "name": "Bhaga",
                "is_auspicious": "false",
                "muhurat_start": "2023-05-24 18:15",
                "muhurat_end": "2023-05-24 19:09",
                "duration_minutes": 55
            }
        ],
        "night_muhurats": [
            {
                "position": 1,
                "period": "Pradosha",
                "special": "Sayan Sandhya",
                "name": "Ishwara",
                "is_auspicious": "false",
                "muhurat_start": "2023-05-24 19:09",
                "muhurat_end": "2023-05-24 19:50",
                "duration_minutes": 41
            },
            {
                "position": 2,
                "period": "Pradosha",
                "special": "1/2 Sayan Sandhya",
                "name": "Ajaikapada",
                "is_auspicious": "false",
                "muhurat_start": "2023-05-24 19:50",
                "muhurat_end": "2023-05-24 20:32",
                "duration_minutes": 41
            },
            {
                "position": 3,
                "period": "Pradosha",
                "special": null,
                "name": "Ahirbudhnya",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-24 20:32",
                "muhurat_end": "2023-05-24 21:13",
                "duration_minutes": 41
            },
            {
                "position": 4,
                "period": "Ratri",
                "special": null,
                "name": "Pusha",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-24 21:13",
                "muhurat_end": "2023-05-24 21:54",
                "duration_minutes": 41
            },
            {
                "position": 5,
                "period": "Ratri",
                "special": null,
                "name": "Ashwini Kumara",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-24 21:54",
                "muhurat_end": "2023-05-24 22:35",
                "duration_minutes": 41
            },
            {
                "position": 6,
                "period": "Ratri",
                "special": null,
                "name": "Yama",
                "is_auspicious": "false",
                "muhurat_start": "2023-05-24 22:35",
                "muhurat_end": "2023-05-24 23:16",
                "duration_minutes": 41
            },
            {
                "position": 7,
                "period": "Ratri",
                "special": null,
                "name": "Agni",
                "is_auspicious": "false",
                "muhurat_start": "2023-05-24 23:16",
                "muhurat_end": "2023-05-24 23:57",
                "duration_minutes": 41
            },
            {
                "position": 8,
                "period": "Nishita",
                "special": "Mahanishita Muhurat",
                "name": "Brahma",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-24 23:57",
                "muhurat_end": "2023-05-25 00:38",
                "duration_minutes": 41
            },
            {
                "position": 9,
                "period": "Ratri",
                "special": null,
                "name": "Chandra",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-25 00:38",
                "muhurat_end": "2023-05-25 01:19",
                "duration_minutes": 41
            },
            {
                "position": 10,
                "period": "Ratri",
                "special": null,
                "name": "Aditi",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-25 01:19",
                "muhurat_end": "2023-05-25 02:00",
                "duration_minutes": 41
            },
            {
                "position": 11,
                "period": "Ratri",
                "special": null,
                "name": "Brihaspati",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-25 02:00",
                "muhurat_end": "2023-05-25 02:41",
                "duration_minutes": 41
            },
            {
                "position": 12,
                "period": "Ratri",
                "special": null,
                "name": "Vishnu",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-25 02:41",
                "muhurat_end": "2023-05-25 03:22",
                "duration_minutes": 41
            },
            {
                "position": 13,
                "period": "Ratri",
                "special": null,
                "name": "Surya",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-25 03:22",
                "muhurat_end": "2023-05-25 04:03",
                "duration_minutes": 41
            },
            {
                "position": 14,
                "period": "Arunodaya",
                "special": "1/2 Pratah Sandhya",
                "name": "Tvashta",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-25 04:03",
                "muhurat_end": "2023-05-25 04:44",
                "duration_minutes": 41
            },
            {
                "position": 15,
                "period": "Arunodaya",
                "special": "Pratah Sandhya",
                "name": "Samirana",
                "is_auspicious": "true",
                "muhurat_start": "2023-05-25 04:44",
                "muhurat_end": "2023-05-25 05:25",
                "duration_minutes": 41
            }
        ]
    }
}

Notes on Response Fields

muhurat_type: The muhurat type, here do-ghati.

date, weekday, sunrise and sunset: The day being analysed and its sunrise and sunset reference times.

day_muhurats and night_muhurats: The Do Ghati muhurats for the day and the night. Each item includes its position, period, name, a special label, an is_auspicious flag, the muhurat_start and muhurat_end times, and the duration_minutes.


Example Code Implementations

Below are example implementations in various programming environments.


cURL

curl --location 'https://astroapi-3.divineapi.com/indian-api/v1/muhurat/do-ghati' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'day="24"' \
--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/do-ghati',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'day': '24',
    '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("day", "24");
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/do-ghati",
  "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/do-ghati"

payload = {'api_key': '{Your API Key}',
'day': '24',
'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.

Example Code
curl -X POST "https://astroapi-3.divineapi.com/indian-api/v1/muhurat/do-ghati" \
  -H "Authorization: Bearer {Your Auth Token}" \
  --form 'api_key="{Your API Key}"' \
  --form 'day="24"' \
  --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"'
const FormData = require('form-data');
const axios = require('axios');

const form = new FormData();
form.append('api_key', '{Your API Key}');
form.append('day', '24');
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');

const response = await axios.post('https://astroapi-3.divineapi.com/indian-api/v1/muhurat/do-ghati', form, {
  headers: {
    ...form.getHeaders(),
    'Authorization': 'Bearer {Your Auth Token}',
  }
});

console.log(response.data);
import requests

url = "https://astroapi-3.divineapi.com/indian-api/v1/muhurat/do-ghati"
headers = {
    "Authorization": "Bearer {Your Auth Token}",
}
payload = {
    "api_key": "{Your API Key}",
    "day": "24",
    "month": "05",
    "year": "2023",
    "place": "New Delhi",
    "lat": "28.6139",
    "lon": "77.2090",
    "tzone": "5.5",
    "lan": "en",
}

response = requests.post(url, headers=headers, data=payload)

print(response.json())
const formData = new FormData();
formData.append('api_key', '{Your API Key}');
formData.append('day', '24');
formData.append('month', '05');
formData.append('year', '2023');
formData.append('place', 'New Delhi');
formData.append('lat', '28.6139');
formData.append('lon', '77.2090');
formData.append('tzone', '5.5');
formData.append('lan', 'en');

const response = await fetch('https://astroapi-3.divineapi.com/indian-api/v1/muhurat/do-ghati', {
  method: 'POST',
  headers: {
      'Authorization': "Bearer {Your Auth Token}",
    },
  body: formData,
});

const data = await response.json();
console.log(data);
<?php

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('POST', 'https://astroapi-3.divineapi.com/indian-api/v1/muhurat/do-ghati', [
    'headers' => [
        'Authorization' => 'Bearer {Your Auth Token}',
    ],
    'multipart' => [
        ['name' => 'api_key', 'contents' => '{Your API Key}'],
        ['name' => 'day', 'contents' => '24'],
        ['name' => 'month', 'contents' => '05'],
        ['name' => 'year', 'contents' => '2023'],
        ['name' => 'place', 'contents' => 'New Delhi'],
        ['name' => 'lat', 'contents' => '28.6139'],
        ['name' => 'lon', 'contents' => '77.2090'],
        ['name' => 'tzone', 'contents' => '5.5'],
        ['name' => 'lan', 'contents' => 'en'],
    ],
]);

echo $response->getBody();
package main

import (
    "bytes"
    "fmt"
    "mime/multipart"
    "net/http"
    "io"
)

func main() {
    body := &bytes.Buffer{}
    writer := multipart.NewWriter(body)
    writer.WriteField("api_key", "{Your API Key}")
    writer.WriteField("day", "24")
    writer.WriteField("month", "05")
    writer.WriteField("year", "2023")
    writer.WriteField("place", "New Delhi")
    writer.WriteField("lat", "28.6139")
    writer.WriteField("lon", "77.2090")
    writer.WriteField("tzone", "5.5")
    writer.WriteField("lan", "en")
    writer.Close()

    req, _ := http.NewRequest("POST", "https://astroapi-3.divineapi.com/indian-api/v1/muhurat/do-ghati", body)
    req.Header.Set("Content-Type", writer.FormDataContentType())
    req.Header.Set("Authorization", "Bearer {Your Auth Token}")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body2, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body2))
}
import okhttp3.*;
import java.io.IOException;

public class Main {
    public static void main(String[] args) throws IOException {
        OkHttpClient client = new OkHttpClient();

        RequestBody body = new MultipartBody.Builder()
            .setType(MultipartBody.FORM)
            .addFormDataPart("api_key", "{Your API Key}")
            .addFormDataPart("day", "24")
            .addFormDataPart("month", "05")
            .addFormDataPart("year", "2023")
            .addFormDataPart("place", "New Delhi")
            .addFormDataPart("lat", "28.6139")
            .addFormDataPart("lon", "77.2090")
            .addFormDataPart("tzone", "5.5")
            .addFormDataPart("lan", "en")
            .build();

        Request request = new Request.Builder()
            .url("https://astroapi-3.divineapi.com/indian-api/v1/muhurat/do-ghati")
            .post(body)
            .addHeader("Authorization", "Bearer {Your Auth Token}")
            .build();

        Response response = client.newCall(request).execute();
        System.out.println(response.body().string());
    }
}
import Foundation

let url = URL(string: "https://astroapi-3.divineapi.com/indian-api/v1/muhurat/do-ghati")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer {Your Auth Token}", forHTTPHeaderField: "Authorization")

let boundary = "Boundary-\(UUID().uuidString)"
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

var bodyData = Data()
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"api_key\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("{Your API Key}\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"day\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("24\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"month\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("05\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"year\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("2023\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"place\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("New Delhi\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"lat\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("28.6139\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"lon\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("77.2090\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"tzone\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("5.5\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"lan\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("en\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)--\r\n".data(using: .utf8)!)
request.httpBody = bodyData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()
import okhttp3.*

fun main() {
    val client = OkHttpClient()

    val body = MultipartBody.Builder()
        .setType(MultipartBody.FORM)
        .addFormDataPart("api_key", "{Your API Key}")
        .addFormDataPart("day", "24")
        .addFormDataPart("month", "05")
        .addFormDataPart("year", "2023")
        .addFormDataPart("place", "New Delhi")
        .addFormDataPart("lat", "28.6139")
        .addFormDataPart("lon", "77.2090")
        .addFormDataPart("tzone", "5.5")
        .addFormDataPart("lan", "en")
        .build()

    val request = Request.Builder()
        .url("https://astroapi-3.divineapi.com/indian-api/v1/muhurat/do-ghati")
        .post(body!!)
        .addHeader("Authorization", "Bearer {Your Auth Token}")
        .build()

    client.newCall(request).execute().use { response ->
        println(response.body?.string())
    }
}
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program {
    static async Task Main() {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer {Your Auth Token}");

        var content = new MultipartFormDataContent();
        content.Add(new StringContent("{Your API Key}"), "api_key");
        content.Add(new StringContent("24"), "day");
        content.Add(new StringContent("05"), "month");
        content.Add(new StringContent("2023"), "year");
        content.Add(new StringContent("New Delhi"), "place");
        content.Add(new StringContent("28.6139"), "lat");
        content.Add(new StringContent("77.2090"), "lon");
        content.Add(new StringContent("5.5"), "tzone");
        content.Add(new StringContent("en"), "lan");

        var response = await client.PostAsync("https://astroapi-3.divineapi.com/indian-api/v1/muhurat/do-ghati", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}