POST

Varjyam information

Calculate Varjyam timings for a specific date and geographical location using traditional Hindu Panchang calculations. Identify these traditionally unfavorable periods associated with Nakshatra-based calculations for Muhurta planning and Vedic astrology applications.

/varjyam

Method

POST

Format

JSON

Auth

API Key

Credits

Overview

The Varjyam API calculates the start and end times of Varjyam for a specific date, time, and geographical location. In traditional Hindu astrology, Varjyam is a period considered unfavorable for certain activities and is associated with Nakshatra-based Panchang calculations.

The API returns the beginning and ending timestamps through the starts_at and ends_at fields. These timings help developers display Varjyam periods for a given location and allow users to consider them when planning activities according to traditional Hindu astrological practices.

This endpoint is useful for building Hindu Panchang applications, daily astrology dashboards, Muhurta planners, religious calendars, and Vedic astrology software. To calculate Varjyam timings, provide the year, month, date, time, latitude, longitude, and timezone. You can also configure the observation point as geocentric or topocentric and specify a supported Ayanamsha setting, such as Lahiri. The API returns the calculated timings in JSON format for easy integration into web applications and mobile apps.

Request Parameters

Parameter	Type	Required	Description	Example
`year`	integer	Yes	Year number, eg: 2023	2023
`month`	integer	Yes	Month number,with no leading zero	7
`date`	integer	Yes	Day number,with no leading zero	5
`hours`	integer	Yes	Hours number,with no leading zero	1
`minutes`	integer	Yes	Minutes number,with no leading zero	1
`seconds`	integer	Yes	Seconds number, with no leading zero	0
`latitude`	float	Yes	Latitude number, in the range from -90 to 90	12.86
`longitude`	float	Yes	Longitude number, in the range from -180 to 180	123.5
`timezone`	float	Yes	Timezone of birth location, eg: 5.5	5.5
📦 `config`	object	No	Contains optional configuration values
`ayanamsha`	string	No	Either "tropical" or "sayana" or "lahiri"	Either "tropical" or "sayana" or "lahiri"
`observation_point`	string	No	Geocentric positions are calculated with respect to the center of Earth. Topocentric positions are calculated with respect to the actual given place	Either "topocentric" or "geocentric"

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.

Response

{
    "statusCode": 200,
    "output": "{\"starts_at\": \"2026-07-25 10:53:25.333333\", \"ends_at\": \"2026-07-25 12:41:18\"}"
}

Code Examples

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

PHP Code

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://json.freeastrologyapi.com/varjyam',
  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": 2026,
    "month": 7,
    "date": 26,
    "hours": 11,
    "minutes": 54,
    "seconds": 0,
    "latitude": 17.383333,
    "longitude": 78.4667,
    "timezone": 5.5,
    "config": {
        
        "observation_point": "geocentric",
        "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;

Python Code

import requests
import json

url = "https://json.freeastrologyapi.com/varjyam"

payload = json.dumps({
  "year": 2026,
  "month": 7,
  "date": 26,
  "hours": 11,
  "minutes": 54,
  "seconds": 0,
  "latitude": 17.383333,
  "longitude": 78.4667,
  "timezone": 5.5,
  "config": {
    "observation_point": "geocentric",
    "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)

Node JS Code

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://json.freeastrologyapi.com/varjyam',
  'headers': {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY_HERE'
  },
  body: JSON.stringify({
    "year": 2026,
    "month": 7,
    "date": 26,
    "hours": 11,
    "minutes": 54,
    "seconds": 0,
    "latitude": 17.383333,
    "longitude": 78.4667,
    "timezone": 5.5,
    "config": {
      "observation_point": "geocentric",
      "ayanamsha": "lahiri"
    }
  })

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