/api/astro/shadbala/1 creditShadbala
Shadbala: the six-fold strength of each of the seven planets, with the six components the total is built from. `shadbala` is the total. `components` breaks it into sthana (positional), dig (directional), kaala (temporal), cheshta (motional), naisargika (natural) and drik (aspectual), so you can show WHY a planet scores as it does rather than only the score. Values are in virupas; sixty virupas make one rupa, and a planet is conventionally judged strong above its own required minimum. Note this endpoint takes `timezone`, not `timezone_as_float`, following its parent. `asc_house` is required on that parent and unused by this calculation, so it is not needed here.
https://yogataraapi.prahlad.app/api/astro/shadbala/Authentication
Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonRequest fields
| Field | Type | Required | Notes |
|---|---|---|---|
| date_time | string (date-time) | required | The moment to calculate for, ISO 8601. ALWAYS include an offset or a trailing Z - a value with no zone is read as Asia/Kolkata (UTC+05:30), not UTC, and can return the previous day's result with a 200. '2026-09-01T06:00:00Z' and '2026-09-01 06:00:00' are different instants and give different answers. |
| latitude | number (double) | required | Latitude of the place, in decimal degrees. Positive is north, negative is south. Example: 26.9124 for Jaipur, 40.7128 for New York. Minutes and seconds are not accepted - convert first. min -89.9 · max 89.9 |
| longitude | number (double) | required | Longitude of the place, in decimal degrees. Positive is east, negative is west. Example: 75.7873 for Jaipur, -74.0060 for New York. Note the sign: a missing minus puts New York in China. min -180 · max 180 |
| timezone | number (double) | required | UTC offset of the place, in hours, as a decimal. Example: 5.5 for India (UTC+05:30). Identical in meaning to timezone_as_float, which other endpoints call the same thing by a different name. min -12 · max 14 |
| asc_house | integer | optional | |
| include_houses | boolean | optional | |
| keys | array | optional | Which calculations to return, as a list of names. See the key table for this endpoint; an unrecognised name rejects the whole request. One call costs one credit however many keys you ask for, so request everything you need at once rather than making several calls. |
| planet_index | integer | optional | |
| use_epoch_table | boolean | optional |
Example request
curl -X POST https://yogataraapi.prahlad.app/api/astro/shadbala/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-09-01T06:00:00+05:30","timezone":5.5,"latitude":26.9124,"longitude":75.7873}'Response
{
"data": {
"shadbala": [
[
238.78,
57.65,
148.43,
187.3,
98.77,
110.72,
175.99
],
[
96.56,
286.1,
115.99,
179.5,
163.42,
155.82,
109.39
],
[
34.21,
18.51,
32.83,
48.89,
82.15,
17.49,
67.94
],
[
0,
0,
2.81,
11.62,
22.59,
0.03,
7.5
],
[
60,
51.43,
17.14,
25.71,
34.29,
42.86,
8.57
],
[
0,
0,
0,
0,
0,
0,
0
],
[
429.55,
413.69,
317.2,
453.02,
401.22,
326.92,
369.39
],
[
7.16,
6.89,
5.29,
7.55,
6.69,
5.45,
6.16
],
[
1.43,
1.15,
1.06,
1.08,
1.03,
0.99,
1.23
]
],
"components": {
"sthana": [
238.78,
57.65,
148.43,
187.3,
98.77,
110.72,
175.99
],
"dig": [
34.21,
18.51,
32.83,
48.89,
82.15,
17.49,
67.94
],
"kaala": [
96.56,
286.1,
115.99,
179.5,
163.42,
155.82,
109.39
],
"cheshta": [
0,
0,
2.81,
11.62,
22.59,
0.03,
7.5
],
"naisargika": [
60,
51.43,
17.14,
25.71,
34.29,
42.86,
8.57
],
"drik": [
0,
0,
0,
0,
0,
0,
0
]
}
},
"status": 200,
"is_error": false,
"message": "successful"
}Captured from a real call using the exact request above. Results sit under data.
Errors
Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.