Vedic Week Day information

Overview

The Vedic Weekday API identifies the conventional weekday and the Vedic weekday for a specific date, time, and geographical location. It is useful for understanding the difference between the standard calendar weekday and the traditional Vedic weekday, which is associated with the Hindu Panchang system.

The API returns the conventional weekday number and name, along with the Vedic weekday number and name. This allows developers to compare both weekday values and display the appropriate information in Panchang applications, Vedic astrology software, Hindu calendar systems, and religious planning tools.

To retrieve weekday information, provide the year, month, date, hours, minutes, seconds, latitude, longitude, and timezone. The request also supports observation-point configuration, such as topocentric or geocentric calculations. The API returns the results in JSON format, making it easy to integrate weekday information into web applications, mobile apps, and astrology platforms.

Request Parameters

Supported Languages

This API endpoint supports the following languages. Use the corresponding 2-letter language code in the language parameter when making your request.

{
    "language": "te"
}

Request Example

{
    "year": 2024,
    "month": 9,
    "date": 1,
    "hours": 20,
    "minutes": 10,
    "seconds": 0,
    "latitude": 29.5523,
    "longitude": 103.7661,
    "timezone": 8,
    "config": {        
        "observation_point": "geocentric", /* topocentric / geocentric */
        "ayanamsha": "lahiri", /* lahiri / sayana */
        "language":"en" /* te / en */
    }
}

Response Examples

Example responses returned by this API.

{
    "statusCode": 200,
    "output": {
        "weekday_number": 7,
        "weekday_name": "रविवार",
        "vedic_weekday_number": 7,
        "vedic_weekday_name": "रविवार"
    }
}

{
    "statusCode": 200,
    "output": {
        "weekday_number": 7,
        "weekday_name": "ఆదివారము",
        "vedic_weekday_number": 7,
        "vedic_weekday_name": "ఆదివారము"
    }
}

{
    "statusCode": 200,
    "output": {
        "weekday_number": 7,
        "weekday_name": "ஞாயிற்றுக்கிழமை",
        "vedic_weekday_number": 7,
        "vedic_weekday_name": "ஞாயிற்றுக்கிழமை"
    }
}

{
    "statusCode": 200,
    "output": {
        "weekday_number": 7,
        "weekday_name": "Sunday",
        "vedic_weekday_number": 7,
        "vedic_weekday_name": "Sunday"
    }
}

{
    "statusCode": 200,
    "output": {
        "weekday_number": 7,
        "weekday_name": "ಭಾನುವಾರ",
        "vedic_weekday_number": 7,
        "vedic_weekday_name": "ಭಾನುವಾರ"
    }
}

{
    "statusCode": 200,
    "output": {
        "weekday_number": 7,
        "weekday_name": "ഞായർ",
        "vedic_weekday_number": 7,
        "vedic_weekday_name": "ഞായർ"
    }
}

{
    "statusCode": 200,
    "output": {
        "weekday_number": 7,
        "weekday_name": "રવિવાર",
        "vedic_weekday_number": 7,
        "vedic_weekday_name": "રવિવાર"
    }
}

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/vedicweekday',
  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": 2024,
    "month": 9,
    "date": 1,
    "hours": 20,
    "minutes": 10,
    "seconds": 0,
    "latitude": 29.5523,
    "longitude": 103.7661,
    "timezone": 8,
    "config": {
        
        "observation_point": "geocentric", 
        "ayanamsha": "lahiri", 
        "language":"ne" 
    }
}',
  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/vedicweekday"

payload = json.dumps({
  "year": 2024,
  "month": 9,
  "date": 1,
  "hours": 20,
  "minutes": 10,
  "seconds": 0,
  "latitude": 29.5523,
  "longitude": 103.7661,
  "timezone": 8,
  "config": {
    "observation_point": "geocentric",
    "ayanamsha": "lahiri",
    "language": "ne"
  }
})
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/vedicweekday',
  'headers': {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY_HERE'
  },
  body: JSON.stringify({
    "year": 2024,
    "month": 9,
    "date": 1,
    "hours": 20,
    "minutes": 10,
    "seconds": 0,
    "latitude": 29.5523,
    "longitude": 103.7661,
    "timezone": 8,
    "config": {
      "observation_point": "geocentric",
      "ayanamsha": "lahiri",
      "language": "ne"
    }
  })

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