Field
year
Type
integer
Required
Yes
Description
Birth year.
Back to Docs
Planetary Strength
Planetary Strength
POST
/api/v2/vedic/strengthCalculate calibrated V2 Shadbala and Ashtakavarga strength metrics for the seven classical grahas.
Authentication: send x-api-key.
Full URL
https://api.freeastroapi.com/api/v2/vedic/strengthSafe retries with Idempotency-Key
Authenticated, billable astrology POST requests accept the optional header Idempotency-Key: <client-generated unique operation key>. Reuse the same key only when retrying the exact same method, path, query string, and JSON body after a timeout or network failure.
A completed replay returns the first response with Idempotency-Replayed: true, does not rerun the calculation, and does not consume extra quota. Keys are retained for about 24 hours.
Reusing a key with a changed request returns 409 idempotency_key_reused. A duplicate while the first request is still running returns 409 request_in_progress with Retry-After.
What It Returns
A production strength payload with Shadbala component rows, total Shadbala values, Sarvashtakavarga, Bhinnashtakavarga, Prastharashtakavarga, and metadata describing the strength engines used.
Example Request
curl -X POST "https://api.freeastroapi.com/api/v2/vedic/strength" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"year": 1997,
"month": 9,
"day": 22,
"hour": 23,
"minute": 25,
"city": "Mumbai",
"lat": 19.391928,
"lng": 72.839732,
"tz_str": "Asia/Kolkata",
"ayanamsha": "lahiri",
"house_system": "whole_sign",
"node_type": "mean"
}'Request Parameters
Provide either city or both lat and lng. Coordinates are recommended for stable production results.
Field
month
Type
integer
Required
Yes
Description
Birth month (1-12).
Field
day
Type
integer
Required
Yes
Description
Birth day.
Field
hour
Type
integer
Required
Yes
Description
Birth hour (0-23).
Field
minute
Type
integer
Required
Yes
Description
Birth minute (0-59).
Field
city
Type
string
Required
No
Description
Birth city. Optional when lat/lng are provided.
Field
lat
Type
float
Required
No
Description
Birth latitude. Recommended for production.
Field
lng
Type
float
Required
No
Description
Birth longitude. Recommended for production.
Field
tz_str
Type
string
Required
No
Description
Optional timezone override such as Asia/Kolkata, Europe/London, AUTO, or LMT. Defaults to AUTO when omitted.
Field
ayanamsha
Type
string
Required
No
Description
Vedic ayanamsha. Default is lahiri.
Field
house_system
Type
string
Required
No
Description
House system. Default is whole_sign.
Field
node_type
Type
string
Required
No
Description
Lunar node type: mean or true.
Response Shape
Field
shadbala
Type
object
Required
n/a
Description
Planet-by-planet Shadbala component rows and totals.
Field
ashtakavarga.sarvashtakavarga
Type
array[number]
Required
n/a
Description
Sarvashtakavarga points by sign/house.
Field
ashtakavarga.bhinnashtakavarga
Type
object
Required
n/a
Description
Bhinnashtakavarga point rows by planet.
Field
ashtakavarga.prastharashtakavarga
Type
object
Required
n/a
Description
Detailed point contribution matrix.
Field
metadata
Type
object
Required
n/a
Description
Endpoint version, ruleset, engine identifiers, and calculation settings.
Real Request Example
This request was captured from the live production endpoint and is the same payload used in the code tabs.
{
"year": 1997,
"month": 9,
"day": 22,
"hour": 23,
"minute": 25,
"city": "Mumbai",
"lat": 19.391928,
"lng": 72.839732,
"tz_str": "Asia/Kolkata",
"ayanamsha": "lahiri",
"house_system": "whole_sign",
"node_type": "mean"
}Real Response Example
This is a real production response for the example payload. Large arrays are intentionally shown as returned by the API.
V2
{
"shadbala": {
"Sun": {
"sthana_bala": 170.74,
"dig_bala": 5.98,
"kala_bala": 122.67,
"cheshta_bala": 30.08,
"naisargika_bala": 60,
"drik_bala": 13.35,
"total": 402.82,
"shadbala_in_rupas": 6.71,
"minimum_requirements": 5,
"ratio": 1.34
},
"Moon": {
"sthana_bala": 198.57,
"dig_bala": 32.69,
"kala_bala": 141.72,
"cheshta_bala": 33.29,
"naisargika_bala": 51.42,
"drik_bala": -5.94,
"total": 451.75,
"shadbala_in_rupas": 7.53,
"minimum_requirements": 6,
"ratio": 1.26
},
"Mars": {
"sthana_bala": 256.3,
"dig_bala": 24.64,
"kala_bala": 86.6,
"cheshta_bala": 25.2,
"naisargika_bala": 17.16,
"drik_bala": -1.79,
"total": 408.11,
"shadbala_in_rupas": 6.8,
"minimum_requirements": 5,
"ratio": 1.36
},
"Mercury": {
"sthana_bala": 227.88,
"dig_bala": 32.95,
"kala_bala": 131.44,
"cheshta_bala": 25,
"naisargika_bala": 25.74,
"drik_bala": 18.17,
"total": 461.18,
"shadbala_in_rupas": 7.69,
"minimum_requirements": 7,
"ratio": 1.1
},
"Jupiter": {
"sthana_bala": 126.43,
"dig_bala": 16.64,
"kala_bala": 167.31,
"cheshta_bala": 46.08,
"naisargika_bala": 34.26,
"drik_bala": -4.27,
"total": 386.45,
"shadbala_in_rupas": 6.44,
"minimum_requirements": 6.5,
"ratio": 0.99
},
"Venus": {
"sthana_bala": 166.54,
"dig_bala": 39.83,
"kala_bala": 109.25,
"cheshta_bala": 30.8,
"naisargika_bala": 42.84,
"drik_bala": 3.18,
"total": 392.44,
"shadbala_in_rupas": 6.54,
"minimum_requirements": 5.5,
"ratio": 1.19
},
"Saturn": {
"sthana_bala": 177.28,
"dig_bala": 21.44,
"kala_bala": 101.91,
"cheshta_bala": 54.1,
"naisargika_bala": 8.58,
"drik_bala": 4.49,
"total": 367.8,
"shadbala_in_rupas": 6.13,
"minimum_requirements": 5,
"ratio": 1.23
}
},
"ashtakavarga": {
"sarvashtakavarga": [
21,
29,
34,
33,
31,
23,
31,
26,
29,
26,
23,
31
],
"bhinnashtakavarga": {
"Sun": [
5,
4,
5,
5,
2,
5,
5,
3,
4,
2,
3,
5
],
"Moon": [
4,
3,
3,
7,
5,
1,
4,
4,
4,
4,
5,
5
],
"Mars": [
0,
3,
5,
3,
2,
3,
5,
4,
4,
3,
3,
4
],
"Mercury": [
2,
5,
7,
3,
7,
2,
5,
4,
7,
4,
5,
3
],
"Jupiter": [
3,
5,
6,
4,
6,
5,
3,
7,
3,
4,
5,
5
],
"Venus": [
4,
5,
5,
6,
5,
4,
5,
3,
5,
6,
1,
3
],
"Saturn": [
3,
4,
3,
5,
4,
3,
4,
1,
2,
3,
1,
6
]
},
"prastharashtakavarga": {
"Sun": {
"Sun": [
1,
1,
1,
1,
0,
1,
1,
0,
1,
0,
0,
1
],
"Moon": [
0,
0,
0,
1,
0,
0,
1,
0,
0,
0,
1,
1
],
"Mars": [
0,
1,
1,
1,
1,
1,
0,
1,
1,
0,
1,
0
],
"Mercury": [
1,
1,
1,
1,
0,
0,
1,
0,
1,
1,
0,
0
],
"Jupiter": [
0,
1,
1,
0,
0,
1,
0,
1,
0,
0,
0,
0
],
"Venus": [
1,
0,
0,
0,
0,
1,
0,
0,
0,
0,
0,
1
],
"Saturn": [
1,
0,
1,
0,
0,
1,
1,
1,
1,
1,
0,
1
],
"Ascendant": [
1,
0,
0,
1,
1,
0,
1,
0,
0,
0,
1,
1
]
},
"Moon": {
"Sun": [
1,
0,
1,
1,
0,
0,
0,
1,
0,
0,
1,
1
],
"Moon": [
0,
1,
0,
1,
0,
0,
1,
1,
0,
0,
1,
1
],
"Mars": [
1,
0,
0,
1,
1,
1,
0,
0,
1,
1,
0,
1
],
"Mercury": [
0,
1,
1,
0,
1,
0,
1,
1,
1,
0,
1,
1
],
"Jupiter": [
1,
0,
0,
1,
1,
0,
1,
1,
1,
1,
0,
0
],
"Venus": [
1,
0,
1,
1,
1,
0,
0,
0,
1,
1,
1,
0
],
"Saturn": [
0,
1,
0,
1,
1,
0,
0,
0,
0,
1,
0,
0
],
"Ascendant": [
0,
0,
0,
1,
0,
0,
1,
0,
0,
0,
1,
1
]
},
"Mars": {
"Sun": [
0,
0,
1,
1,
0,
0,
0,
1,
0,
1,
1,
0
],
"Moon": [
0,
0,
0,
1,
0,
0,
1,
0,
0,
0,
0,
1
],
"Mars": [
0,
1,
1,
0,
1,
1,
0,
1,
1,
0,
1,
0
],
"Mercury": [
0,
0,
1,
0,
0,
0,
1,
0,
1,
1,
0,
0
],
"Jupiter": [
0,
0,
1,
0,
0,
0,
1,
1,
1,
0,
0,
0
],
"Venus": [
0,
1,
0,
0,
1,
1,
0,
0,
0,
0,
0,
1
],
"Saturn": [
0,
0,
1,
0,
0,
1,
1,
1,
1,
1,
0,
1
],
"Ascendant": [
0,
1,
0,
1,
0,
0,
1,
0,
0,
0,
1,
1
]
},
"Mercury": {
"Sun": [
0,
1,
0,
1,
1,
0,
0,
0,
0,
1,
1,
0
],
"Moon": [
0,
0,
1,
0,
1,
0,
1,
0,
1,
0,
1,
1
],
"Mars": [
0,
1,
1,
1,
1,
1,
0,
1,
1,
0,
1,
0
],
"Mercury": [
1,
1,
1,
1,
1,
0,
1,
0,
1,
1,
0,
0
],
"Jupiter": [
0,
0,
1,
0,
1,
0,
0,
1,
1,
0,
0,
0
],
"Venus": [
0,
1,
1,
0,
1,
0,
1,
1,
1,
1,
1,
0
],
"Saturn": [
1,
0,
1,
0,
0,
1,
1,
1,
1,
1,
0,
1
],
"Ascendant": [
0,
1,
1,
0,
1,
0,
1,
0,
1,
0,
1,
1
]
},
"Jupiter": {
"Sun": [
1,
1,
1,
1,
0,
1,
1,
1,
1,
0,
0,
1
],
"Moon": [
0,
0,
1,
0,
0,
1,
0,
1,
0,
1,
0,
1
],
"Mars": [
0,
1,
1,
0,
1,
1,
0,
1,
1,
0,
1,
0
],
"Mercury": [
1,
1,
1,
0,
1,
1,
0,
1,
1,
1,
0,
0
],
"Jupiter": [
1,
0,
0,
1,
1,
0,
1,
1,
0,
1,
1,
1
],
"Venus": [
0,
0,
1,
1,
1,
0,
0,
1,
0,
0,
1,
1
],
"Saturn": [
0,
1,
0,
1,
1,
0,
0,
0,
0,
0,
1,
0
],
"Ascendant": [
0,
1,
1,
0,
1,
1,
1,
1,
0,
1,
1,
1
]
},
"Venus": {
"Sun": [
1,
0,
0,
1,
1,
0,
0,
0,
0,
0,
0,
0
],
"Moon": [
1,
1,
1,
1,
1,
1,
0,
0,
1,
1,
0,
1
],
"Mars": [
1,
0,
0,
1,
0,
1,
1,
0,
0,
1,
0,
1
],
"Mercury": [
1,
0,
1,
0,
0,
0,
1,
0,
1,
1,
0,
0
],
"Jupiter": [
0,
1,
0,
0,
1,
1,
1,
1,
0,
0,
0,
0
],
"Venus": [
0,
1,
1,
1,
1,
0,
1,
1,
1,
1,
1,
0
],
"Saturn": [
0,
1,
1,
1,
0,
0,
1,
1,
1,
1,
0,
0
],
"Ascendant": [
0,
1,
1,
1,
1,
1,
0,
0,
1,
1,
0,
1
]
},
"Saturn": {
"Sun": [
1,
0,
1,
1,
0,
1,
1,
0,
1,
0,
0,
1
],
"Moon": [
0,
0,
0,
1,
0,
0,
1,
0,
0,
0,
0,
1
],
"Mars": [
1,
0,
0,
0,
1,
1,
1,
0,
0,
1,
0,
1
],
"Mercury": [
1,
1,
1,
1,
0,
0,
0,
0,
0,
1,
0,
1
],
"Jupiter": [
0,
1,
1,
0,
0,
0,
0,
1,
1,
0,
0,
0
],
"Venus": [
0,
0,
0,
0,
1,
1,
0,
0,
0,
0,
0,
1
],
"Saturn": [
0,
1,
0,
1,
1,
0,
0,
0,
0,
1,
0,
0
],
"Ascendant": [
0,
1,
0,
1,
1,
0,
1,
0,
0,
0,
1,
1
]
}
},
"total_points": 337
},
"metadata": {
"endpoint_version": "v2",
"ruleset_version": "classical_strength_v1",
"ayanamsha": "lahiri",
"house_system": "whole_sign",
"node_type": "mean",
"timezone_used": "Asia/Kolkata",
"shadbala_engine": "classical_v1",
"ashtakavarga_engine": "classical_v1",
"dig_bala_basis": "placidus_sidereal"
}
}