Ritu information

Overview

The Ritu Information API identifies the traditional Hindu season (Ritu) for a given date, time, and geographical location. The Hindu calendar recognizes six seasons, known as Ritus, each representing a distinct phase of the traditional annual cycle.

The six Ritus are Vasanta (Spring), Grishma (Summer), Varsha (Monsoon), Sharad (Autumn), Hemanta (Pre-Winter), and Shishira (Winter). This seasonal classification is an important part of traditional Hindu calendar systems and can be used to display seasonal information in Panchang applications and Vedic astrology software.

The API returns the Ritu number and name, including its English seasonal equivalent where available. To retrieve Ritu information, provide the year, month, date, time, latitude, longitude, and timezone. You can also configure the observation point as geocentric or topocentric. The result is returned in JSON format for easy integration into web applications, mobile apps, Hindu calendars, and astrology platforms.

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,
    "output": {
        "number": 6,
        "name": "Sisira (Winter & Fall)"
    }
}

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/rituinfo',
  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": 1,
    "date": 22,
    "hours": 12,
    "minutes": 10,
    "seconds": 53,
    "latitude": 1.4433887,
    "longitude": 103.8325013,
    "timezone":8,
    "config": {
              "language":"te",
        "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;

import requests
import json

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

payload = json.dumps({
  "year": 2025,
  "month": 1,
  "date": 22,
  "hours": 12,
  "minutes": 10,
  "seconds": 53,
  "latitude": 1.4433887,
  "longitude": 103.8325013,
  "timezone": 8,
  "config": {
    "language": "te",
    "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)

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://json.freeastrologyapi.com/rituinfo',
  'headers': {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY_HERE'
  },
  body: JSON.stringify({
    "year": 2025,
    "month": 1,
    "date": 22,
    "hours": 12,
    "minutes": 10,
    "seconds": 53,
    "latitude": 1.4433887,
    "longitude": 103.8325013,
    "timezone": 8,
    "config": {
      "language": "te",
      "observation_point": "geocentric",
      "ayanamsha": "lahiri"
    }
  })

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