Good and Bad Times

Overview

The Good and Bad Times API calculates important auspicious and inauspicious time periods for a specific date and geographical location according to traditional Hindu Panchang principles. It helps developers display favorable timings for spiritual practices and daily activities, as well as periods traditionally avoided for starting important work.

The API provides the start and end times for several important periods, including Abhijit Muhurat, Amrit Kaal, Brahma Muhurat, Rahu Kaal, Yama Gandam, Gulika Kalam, Dur Muhurat, and Varjyam. These timings are commonly used in Hindu religious calendars, daily Panchang calculations, and traditional Muhurta selection.

This endpoint is useful for building Panchang applications, Hindu calendar systems, daily astrology dashboards, Muhurta planners, and Vedic astrology software. To calculate these periods, provide the year, month, date, time, latitude, longitude, and timezone. You can also configure the observation point as geocentric or topocentric. The API returns the calculated timings in JSON format, making it easy to integrate auspicious and inauspicious time information into web applications and mobile apps.

Request Parameters

Request Example

{
    "year": 2022,
    "month": 8,
    "date": 11,
    "hours": 6,
    "minutes": 0,
    "seconds": 0,
    "latitude": 17.38333,
    "longitude": 78.4666,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric",
        "ayanamsha": "lahiri"
    }
}

Response Examples

Example responses returned by this API.

{
    "statusCode": 200,
    "abhijit_data": "{\"starts_at\": \"2025-08-26 11:58:29.600000\", \"ends_at\": \"2025-08-26 12:49:25.400000\"}",
    "amrit_kaal_data": "{\"starts_at\": \"2025-08-26 22:19:22.250000\", \"ends_at\": \"2025-08-27 00:05:25.116667\"}",
    "brahma_muhurat_data": "{\"starts_at\": \"2025-08-26 04:25:59\", \"ends_at\": \"2025-08-26 05:13:59\"}",
    "rahu_kaalam_data": "{\"starts_at\": \"2025-08-26 15:34:56.750000\", \"ends_at\": \"2025-08-26 17:10:26.375000\"}",
    "yama_gandam_data": "{\"starts_at\": \"2025-08-26 09:12:58.250000\", \"ends_at\": \"2025-08-26 10:48:27.875000\"}",
    "gulika_kalam_data": "{\"starts_at\": \"2025-08-26 12:23:57.500000\", \"ends_at\": \"2025-08-26 13:59:27.125000\"}",
    "dur_muhurat_data": "{\"1\": {\"starts_at\": \"2025-08-26 08:34:46.400000\", \"ends_at\": \"2025-08-26 09:25:42.200000\"}, \"2\": {\"starts_at\": \"2025-08-26 23:16:29.200000\", \"ends_at\": \"2025-08-27 00:01:34.733333\"}}",
    "varjyam_data": "{\"starts_at\": \"2025-08-25 08:17:14.100000\", \"ends_at\": \"2025-08-25 10:00:57.233333\"}"
}

Code Examples

Use the following examples to integrate this API into your application.

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://json.freeastrologyapi.com/good-bad-times',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "year": 2025,
    "month": 8,
    "date": 26,
    "hours": 8,
    "minutes": 0,
    "seconds": 0,
    "latitude": 22.70,
    "longitude": 77.10,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric",
        "ayanamsha": "lahiri"
    }
    }',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'x-api-key: YOUR_API_KEY_HERE'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

import requests
import json

url = "https://json.freeastrologyapi.com/good-bad-times"

payload = json.dumps({
  "year": 2025,
  "month": 8,
  "date": 26,
  "hours": 8,
  "minutes": 0,
  "seconds": 0,
  "latitude": 22.7,
  "longitude": 77.1,
  "timezone": 5.5,
  "config": {
    "observation_point": "topocentric",
    "ayanamsha": "lahiri"
  }
})
headers = {
  'Content-Type': 'application/json',
  'x-api-key': 'YOUR_API_KEY_HERE'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://json.freeastrologyapi.com/good-bad-times',
  'headers': {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY_HERE'
  },
  body: JSON.stringify({
    "year": 2025,
    "month": 8,
    "date": 26,
    "hours": 8,
    "minutes": 0,
    "seconds": 0,
    "latitude": 22.7,
    "longitude": 77.1,
    "timezone": 5.5,
    "config": {
      "observation_point": "topocentric",
      "ayanamsha": "lahiri"
    }
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});