Varshphal Yogas API

The Varshphal Yogas API is part of the Varshphal (annual horoscope) suite and returns the Tajika yogas, such as Ikabala and Induvara yoga, present in the annual chart for the chosen year. Provide the birth details along with the varshphal_year.

API Endpoint

POST https://astroapi-3.divineapi.com/indian-api/v1/varshphal/yogas

Returns the Tajika yogas of the annual chart in the response.

Supported Language Codes

You can localize the API response by passing the lan parameter in the request body.

Code	Language
en	English
hi	Hindi
bn	Bengali
ma	Marathi
tm	Tamil
tl	Telugu
ml	Malayalam
kn	Kannada

Support Article: Translating Vedic APIs into Different Languages

Headers

Name	Type	Description
Authorization *	String	Your API Access Token, e.g. `Bearer {token}`

Request Body

Name	Type	Description
api_key *	String	Your API key
full_name *	String	Full name, e.g. `Rahul Kumar`
day *	Integer	Date of birth, e.g. `24`
month *	Integer	Month of birth, e.g. `05`
year *	Integer	Year of birth, e.g. `2023`
hour *	Integer	Hour (24-hour format), e.g. `14`
min *	Integer	Minute, e.g. `40`
sec *	Integer	Second, e.g. `43`
gender *	String	Gender, e.g. `male`
place *	String	Place of birth, e.g. `New Delhi`
lat *	Float	Latitude, e.g. `28.7041`
lon *	Float	Longitude, e.g. `77.1025`
tzone *	Float	Timezone, e.g. `5.5` — See Timezone List
varshphal_year *	Integer	The year for which the annual (Varshphal) horoscope is calculated, e.g. `2024`
lan	String	Language code as per the table above; default is `en`

200: OK Yogas Fetched Successfully

{
    "success": 1,
    "data": {
        "ikabala_yoga": {
            "is_valid": "false",
            "grade": "none",
            "content": ""
        },
        "induvara_yoga": {
            "is_valid": "false",
            "grade": "partial",
            "content": "This yoga is considered inauspicious. It leads to disappointments, fall in status, illness, mental worries, and fear from opponents."
        },
        "ithasala_yoga": {
            "is_valid": "true",
            "data": [
                {
                    "planet_one": "Sun",
                    "planet_two": "Venus",
                    "aspect": "Negative",
                    "obrs": 3.24,
                    "type": "Vartamana"
                },
                {
                    "planet_one": "Saturn",
                    "planet_two": "Mercury",
                    "aspect": "Positive",
                    "obrs": 7.17,
                    "type": "Vartamana"
                },
                {
                    "planet_one": "Jupiter",
                    "planet_two": "Venus",
                    "aspect": "Negative",
                    "obrs": 0.29,
                    "type": "Poorna"
                }
            ],
            "content": "It signifies an exercise of mutual influence between the participating planets, and the fulfilment of the event they signify."
        },
        "ishrafa_yoga": {
            "is_valid": "true",
            "data": [
                {
                    "planet_one": "Venus",
                    "planet_two": "Moon",
                    "aspect": "Negative",
                    "obrs": 4.01
                },
                {
                    "planet_one": "Jupiter",
                    "planet_two": "Sun",
                    "aspect": "Negative",
                    "obrs": 3.53
                },
                {
                    "planet_one": "Jupiter",
                    "planet_two": "Moon",
                    "aspect": "Negative",
                    "obrs": 4.3
                }
            ],
            "content": "This yoga is the reverse of the Ithasala. It indicates obstacles and failures."
        },
        "nakta_yoga": {
            "is_valid": "false",
            "data": [],
            "content": ""
        },
        "yamaya_yoga": {
            "is_valid": "false",
            "data": [],
            "content": ""
        },
        "manau_yoga": {
            "is_valid": "false",
            "data": [],
            "content": ""
        },
        "kamboola_yoga": {
            "is_valid": "false",
            "data": [],
            "content": ""
        },
        "gairi_kamboola_yoga": {
            "is_valid": "false",
            "data": [],
            "content": ""
        },
        "khallasara_yoga": {
            "is_valid": "false",
            "data": [],
            "content": ""
        },
        "rudda_yoga": {
            "is_valid": "true",
            "data": [
                {
                    "lagnesh": "Jupiter",
                    "karyesha": "Venus",
                    "afflicted": {
                        "Jupiter": [
                            "combust",
                            "in house 6",
                            "in inimical sign",
                            "malefic influence (Saturn)"
                        ],
                        "Venus": [
                            "combust",
                            "in house 6",
                            "malefic influence (Saturn)"
                        ]
                    }
                }
            ],
            "content": "Destruction of the results indicated by the Ithasala yoga."
        },
        "duhphali_kuttha_yoga": {
            "is_valid": "false",
            "data": [],
            "content": ""
        },
        "dutthottha_davira_yoga": {
            "is_valid": "true",
            "data": [
                {
                    "lagnesh": "Jupiter",
                    "karyesha": "Sun",
                    "via": "Venus"
                },
                {
                    "lagnesh": "Jupiter",
                    "karyesha": "Moon",
                    "via": "Venus"
                },
                {
                    "lagnesh": "Jupiter",
                    "karyesha": "Mars",
                    "via": "Venus"
                }
            ],
            "content": "Realisation of the motive with the help of someone else."
        },
        "tambira_yoga": {
            "is_valid": "false",
            "data": [],
            "content": ""
        },
        "kuttha_yoga": {
            "is_valid": "false",
            "data": [],
            "content": ""
        },
        "durapha_yoga": {
            "is_valid": "false",
            "data": [],
            "content": ""
        }
    }
}

Code Integration Examples

Below are examples for using this API in different programming environments.

cURL Example

curl --location 'https://astroapi-3.divineapi.com/indian-api/v1/varshphal/yogas' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'full_name="Test"' \
--form 'day="24"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'hour="14"' \
--form 'min="40"' \
--form 'sec="43"' \
--form 'gender="male"' \
--form 'place="New Delhi"' \
--form 'lat="28.7041"' \
--form 'lon="77.1025"' \
--form 'tzone="5.5"' \
--form 'varshphal_year="2024"' \
--form 'lan="en"' \

NodeJS Example

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-3.divineapi.com/indian-api/v1/varshphal/yogas',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'full_name': 'Test',
    'day': '24',
    'month': '05',
    'year': '2023',
    'hour': '14',
    'min': '40',
    'sec': '43',
    'gender': 'male',
    'place': 'New Delhi',
    'lat': '28.7041',
    'lon': '77.1025',
    'tzone': '5.5',
    'varshphal_year': '2024',
    'lan': 'en'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

JavaScript (jQuery AJAX) Example

var form = new FormData();
form.append("api_key", "{Your API Key}");
form.append("full_name", "Test");
form.append("day", "24");
form.append("month", "05");
form.append("year", "2023");
form.append("hour", "14");
form.append("min", "40");
form.append("sec", "43");
form.append("gender", "male");
form.append("place", "New Delhi");
form.append("lat", "28.7041");
form.append("lon", "77.1025");
form.append("tzone", "5.5");
form.append("varshphal_year", "2024");
form.append("lan", "en");

var settings = {
  "url": "https://astroapi-3.divineapi.com/indian-api/v1/varshphal/yogas",
  "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 Example

import requests

url = "https://astroapi-3.divineapi.com/indian-api/v1/varshphal/yogas"

payload = {'api_key': '{Your API Key}',
'full_name': 'Test',
'day': '24',
'month': '05',
'year': '2023',
'hour': '14',
'min': '40',
'sec': '43',
'gender': 'male',
'place': 'New Delhi',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5',
'varshphal_year': '2024',
'lan': 'en'}

headers = {
  'Authorization': 'Bearer {Your Auth Token}'
}

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

print(response.text)

This API serves as a foundation for further astrological computations, including Kundli generation, planetary charts, yogas, and personalized reports. It provides all key birth-time astrological parameters such as tithi, nakshatra, rashi, yoga, karana, varna, gana, and planetary influences, essential for deeper Vedic analysis.