Varshphal Sahams API
The Varshphal Sahams API is part of the Varshphal (annual horoscope) suite and returns the Sahams, the sensitive points such as Punya Saham computed for 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/sahams
Returns the Sahams (sensitive points such as Punya Saham) 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 Sahams Fetched Successfully
{
"success": 1,
"data": {
"punya_saham": {
"saham": "Punya ( Fortune )",
"sign_no": 3,
"sign": "ge",
"sign_name": "Gemini",
"longitude": "2:5:59",
"full_degree": 62.0999836,
"lord": "Mercury",
"house": 7
},
"guru_saham": {
"saham": "Guru ( Preceptor )",
"sign_no": 4,
"sign": "cn",
"sign_name": "Cancer",
"longitude": "3:38:28",
"full_degree": 93.64138200000002,
"lord": "Moon",
"house": 8
},
"vidya_saham": {
"saham": "Vidya ( Knowledge/Education )",
"sign_no": 4,
"sign": "cn",
"sign_name": "Cancer",
"longitude": "3:38:28",
"full_degree": 93.64138200000002,
"lord": "Moon",
"house": 8
},
"yasha_saham": {
"saham": "Yasha ( Fame )",
"sign_no": 10,
"sign": "cp",
"sign_name": "Capricorn",
"longitude": "29:42:51",
"full_degree": 299.7144102,
"lord": "Saturn",
"house": 2
},
"mitra_saham": {
"saham": "Mitra ( Friends )",
"sign_no": 1,
"sign": "ar",
"sign_name": "Aries",
"longitude": "4:0:10",
"full_degree": 4.003033799999983,
"lord": "Mars",
"house": 5
},
"mahatmya_saham": {
"saham": "Mahatmya ( Virtuous Living )",
"sign_no": 6,
"sign": "vi",
"sign_name": "Virgo",
"longitude": "24:9:16",
"full_degree": 174.15450639999995,
"lord": "Mercury",
"house": 10
},
"asha_saham": {
"saham": "Asha ( Hope/Anticipation )",
"sign_no": 12,
"sign": "pi",
"sign_name": "Pisces",
"longitude": "14:18:19",
"full_degree": 344.3055073,
"lord": "Jupiter",
"house": 4
},
"samarthya_saham": {
"saham": "Samarthya ( Capability )",
"sign_no": 11,
"sign": "aq",
"sign_name": "Aquarius",
"longitude": "14:44:35",
"full_degree": 314.7431318,
"lord": "Saturn",
"house": 3
},
"bhratri_saham": {
"saham": "Bhratri ( Siblings )",
"sign_no": 12,
"sign": "pi",
"sign_name": "Pisces",
"longitude": "14:1:2",
"full_degree": 344.01733129999997,
"lord": "Jupiter",
"house": 4
},
"gaurava_saham": {
"saham": "Gaurava ( Dignity )",
"sign_no": 9,
"sign": "sa",
"sign_name": "Sagittarius",
"longitude": "6:1:37",
"full_degree": 246.0269554,
"lord": "Jupiter",
"house": 1
},
"pitri_saham": {
"saham": "Pitri ( Father )",
"sign_no": 12,
"sign": "pi",
"sign_name": "Pisces",
"longitude": "17:32:49",
"full_degree": 347.54703969999997,
"lord": "Jupiter",
"house": 4
},
"raja_saham": {
"saham": "Raja ( Kingship )",
"sign_no": 12,
"sign": "pi",
"sign_name": "Pisces",
"longitude": "17:32:49",
"full_degree": 347.54703969999997,
"lord": "Jupiter",
"house": 4
},
"matri_saham": {
"saham": "Matri ( Mother )",
"sign_no": 2,
"sign": "ta",
"sign_name": "Taurus",
"longitude": "28:51:30",
"full_degree": 58.85845119999999,
"lord": "Venus",
"house": 6
},
"putra_saham": {
"saham": "Putra ( Children )",
"sign_no": 2,
"sign": "ta",
"sign_name": "Taurus",
"longitude": "28:34:12",
"full_degree": 58.5702752,
"lord": "Venus",
"house": 6
},
"jeeva_saham": {
"saham": "Jeeva ( Life )",
"sign_no": 12,
"sign": "pi",
"sign_name": "Pisces",
"longitude": "14:1:2",
"full_degree": 344.01733129999997,
"lord": "Jupiter",
"house": 4
},
"roga_saham": {
"saham": "Roga ( Disease )",
"sign_no": 6,
"sign": "vi",
"sign_name": "Virgo",
"longitude": "18:19:3",
"full_degree": 168.31773889999997,
"lord": "Mercury",
"house": 10
},
"karma_saham": {
"saham": "Karma ( Actions )",
"sign_no": 10,
"sign": "cp",
"sign_name": "Capricorn",
"longitude": "26:25:51",
"full_degree": 296.43107000000003,
"lord": "Saturn",
"house": 2
},
"manmatha_saham": {
"saham": "Manmatha ( Infatuation )",
"sign_no": 2,
"sign": "ta",
"sign_name": "Taurus",
"longitude": "28:34:12",
"full_degree": 58.5702752,
"lord": "Venus",
"house": 6
},
"kali_saham": {
"saham": "Kali ( Strife )",
"sign_no": 7,
"sign": "li",
"sign_name": "Libra",
"longitude": "20:59:53",
"full_degree": 200.99823379999998,
"lord": "Venus",
"house": 11
},
"kshama_saham": {
"saham": "Kshama ( Forgiveness )",
"sign_no": 7,
"sign": "li",
"sign_name": "Libra",
"longitude": "20:59:53",
"full_degree": 200.99823379999998,
"lord": "Venus",
"house": 11
},
"shastra_saham": {
"saham": "Shastra ( Scriptures )",
"sign_no": 12,
"sign": "pi",
"sign_name": "Pisces",
"longitude": "5:47:51",
"full_degree": 335.79754590000005,
"lord": "Jupiter",
"house": 4
},
"bandhu_saham": {
"saham": "Bandhu ( Relatives )",
"sign_no": 2,
"sign": "ta",
"sign_name": "Taurus",
"longitude": "10:15:29",
"full_degree": 40.25821339999999,
"lord": "Venus",
"house": 6
},
"mrityu_saham": {
"saham": "Mrityu ( Death )",
"sign_no": 7,
"sign": "li",
"sign_name": "Libra",
"longitude": "22:12:48",
"full_degree": 202.21345523333335,
"lord": "Venus",
"house": 11
},
"deshantara_saham": {
"saham": "Deshantara ( Foreign Travels )",
"sign_no": 1,
"sign": "ar",
"sign_name": "Aries",
"longitude": "6:32:6",
"full_degree": 6.535058066666636,
"lord": "Mars",
"house": 5
},
"artha_saham": {
"saham": "Artha/Dhana ( Finance/Wealth )",
"sign_no": 7,
"sign": "li",
"sign_name": "Libra",
"longitude": "16:25:17",
"full_degree": 196.4215864333333,
"lord": "Venus",
"house": 11
},
"paradara_saham": {
"saham": "Paradara ( Adultery )",
"sign_no": 8,
"sign": "sc",
"sign_name": "Scorpio",
"longitude": "29:37:44",
"full_degree": 239.62915040000001,
"lord": "Mars",
"house": 12
},
"anya_karma_saham": {
"saham": "Anya-Karma ( Alternate Vocation )",
"sign_no": 12,
"sign": "pi",
"sign_name": "Pisces",
"longitude": "17:25:25",
"full_degree": 347.4236267,
"lord": "Jupiter",
"house": 4
},
"vanika_saham": {
"saham": "Vanika ( Trade )",
"sign_no": 4,
"sign": "cn",
"sign_name": "Cancer",
"longitude": "25:28:59",
"full_degree": 115.4831522,
"lord": "Moon",
"house": 8
},
"karya_siddhi_saham": {
"saham": "Karya-Siddhi ( Success )",
"sign_no": 5,
"sign": "le",
"sign_name": "Leo",
"longitude": "7:56:12",
"full_degree": 127.93675110000004,
"lord": "Sun",
"house": 9
},
"vivaha_saham": {
"saham": "Vivaha ( Marriage )",
"sign_no": 12,
"sign": "pi",
"sign_name": "Pisces",
"longitude": "14:18:19",
"full_degree": 344.3055073,
"lord": "Jupiter",
"house": 4
},
"prasava_saham": {
"saham": "Prasava ( Delivery of Child )",
"sign_no": 8,
"sign": "sc",
"sign_name": "Scorpio",
"longitude": "14:33:31",
"full_degree": 224.558621,
"lord": "Mars",
"house": 12
},
"santaapa_saham": {
"saham": "Santaapa ( Sorrows )",
"sign_no": 6,
"sign": "vi",
"sign_name": "Virgo",
"longitude": "22:12:48",
"full_degree": 172.21345523333335,
"lord": "Mercury",
"house": 10
},
"shraddha_saham": {
"saham": "Shraddha ( Devotion )",
"sign_no": 11,
"sign": "aq",
"sign_name": "Aquarius",
"longitude": "15:1:52",
"full_degree": 315.03130780000004,
"lord": "Saturn",
"house": 3
},
"preeti_saham": {
"saham": "Preeti ( Love )",
"sign_no": 11,
"sign": "aq",
"sign_name": "Aquarius",
"longitude": "4:24:43",
"full_degree": 304.4120812,
"lord": "Saturn",
"house": 3
},
"jadya_saham": {
"saham": "Jadya ( Stupidity )",
"sign_no": 12,
"sign": "pi",
"sign_name": "Pisces",
"longitude": "17:40:11",
"full_degree": 347.66999490000006,
"lord": "Jupiter",
"house": 4
},
"vyapara_saham": {
"saham": "Vyapara ( Business )",
"sign_no": 8,
"sign": "sc",
"sign_name": "Scorpio",
"longitude": "9:18:37",
"full_degree": 219.31029560000002,
"lord": "Mars",
"house": 12
},
"paneeya_paata_saham": {
"saham": "Paneeya-Paata ( Drowning )",
"sign_no": 6,
"sign": "vi",
"sign_name": "Virgo",
"longitude": "18:19:3",
"full_degree": 168.31773889999997,
"lord": "Mercury",
"house": 10
},
"shatru_saham": {
"saham": "Shatru ( Enemies )",
"sign_no": 8,
"sign": "sc",
"sign_name": "Scorpio",
"longitude": "3:35:47",
"full_degree": 213.59648330000005,
"lord": "Mars",
"house": 12
},
"jalapatha_saham": {
"saham": "Jalapatha ( Voyages )",
"sign_no": 4,
"sign": "cn",
"sign_name": "Cancer",
"longitude": "11:58:49",
"full_degree": 101.98029050000002,
"lord": "Moon",
"house": 8
},
"bandhana_saham": {
"saham": "Bandhana ( Imprisonment )",
"sign_no": 5,
"sign": "le",
"sign_name": "Leo",
"longitude": "24:52:49",
"full_degree": 144.8803069,
"lord": "Sun",
"house": 9
},
"labha_saham": {
"saham": "Labha ( Monetary Gains )",
"sign_no": 3,
"sign": "ge",
"sign_name": "Gemini",
"longitude": "9:46:35",
"full_degree": 69.77659046666668,
"lord": "Mercury",
"house": 7
}
}
}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/sahams' \
--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/sahams',
'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/sahams",
"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/sahams"
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.