/api/astro/muddha_dasha/1 creditMuddha dasha
Muddha dasha, also called Varsha Vimshottari, is the annual-chart counterpart of the ordinary Vimshottari dasha: the same nine planetary periods in the same sequence, compressed from 120 years into the single solar-return year you are examining. It is one of the standard timing tools of Tajika (Varshaphala) practice, used to say which stretch of a particular year belongs to which planet. Pass the birth details plus years — the number of completed years since birth, which selects the annual chart — and include_antardhasa. With antardashas you get 81 rows; without, nine. Two things to watch in the output. The lords are integers rather than names: 0 Sun, 1 Moon, 2 Mars, 3 Mercury, 4 Jupiter, 5 Venus, 6 Saturn, 7 Rahu, 8 Ketu. And each start date is a string of the form "2025-02-02 {'degrees': 13, 'minutes': 0, 'seconds': 54.16}", where the braced part is the time of day left in the degrees-minutes-seconds form the Julian-day conversion produced rather than converted to hours. Durations are in days, and the nine top-level periods add up to one tropical year.
https://yogataraapi.prahlad.app/api/astro/muddha_dasha/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. |
| include_antardhasa | boolean | required | |
| keys | array | required | 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. |
| 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 -90 · max 90 |
| 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_as_float | number (double) | required | UTC offset of the place, in hours, as a decimal. Example: 5.5 for India (UTC+05:30), -5 for New York in winter, 5.75 for Nepal. This is NOT validated against date_time - if the two disagree you get a successful response for the wrong moment, so derive both from the same source. Use the offset in force on that date, not today's: a summer birth in a country with daylight saving needs the summer offset. min -12 · max 14 |
| years | integer | required |
Available keys (1)
Ask for exactly the calculations you want by listing them in keys. An unknown key rejects the whole request, and you are charged 1 credit however many you ask for — so batch them.
| Key | Extra fields needed | Description |
|---|---|---|
| mudda_dhasa_bhukthi | include_antardhasa | The Muddha (Varsha Vimshottari) periods for the annual chart selected by years. With include_antardhasa true it returns 81 rows of [dasha lord, bhukti lord, start, duration]; with it false, nine rows of [dasha lord, start, duration]. Lords are integers (0 Sun, 1 Moon, 2 Mars, 3 Mercury, 4 Jupiter, 5 Venus, 6 Saturn, 7 Rahu, 8 Ketu), durations are in days summing to one tropical year, and each start is a string combining the date with a degrees-minutes-seconds rendering of the time of day. |
Example request
curl -X POST https://yogataraapi.prahlad.app/api/astro/muddha_dasha/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["mudda_dhasa_bhukthi"],"years":0,"date_time":"2025-02-13T05:10:10.565Z","include_antardhasa":true,"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'Response
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"mudda_dhasa_bhukthi\": [[0, 0, \"2025-02-02 {'degrees': 13, 'minutes': 0, 'seconds': 54.16}\", 0.91], [0, 1, \"2025-02-03 {'degrees': 10, 'minutes': 55, 'seconds': 46.47}\", 1.52], [0, 2, \"2025-02-04 {'degrees': 23, 'minutes': 27, 'seconds': 13.66}\", 1.07], [0, 7, \"2025-02-06 {'degrees': 1, 'minutes': 1, 'seconds': 14.69}\", 2.74], [0, 4, \"2025-02-08 {'degrees': 18, 'minutes': 45, 'seconds': 51.63}\", 2.43], [0, 6, \"2025-02-11 {'degrees': 5, 'minutes': 12, 'seconds': 11.13}\", 2.89], [0, 3, \"2025-02-14 {'degrees': 2, 'minutes': 35, 'seconds': 56.79}\", 2.59], [0, 8, \"2025-02-16 {'degrees': 16, 'minutes': 41, 'seconds': 25.01}\", 1.07], [0, 5, \"2025-02-17 {'degrees': 18, 'minutes': 15, 'seconds': 26.04}\", 3.04], [1, 1, \"2025-02-20 {'degrees': 19, 'minutes': 18, 'seconds': 20.42}\", 2.54], [1, 2, \"2025-02-23 {'degrees': 8, 'minutes': 10, 'seconds': 45.73}\", 1.78], [1, 7, \"2025-02-25 {'degrees': 2, 'minutes': 47, 'seconds': 27.45}\", 4.57], [1, 4, \"2025-03-01 {'degrees': 16, 'minutes': 21, 'seconds': 49.02}\", 4.06], [1, 6, \"2025-03-05 {'degrees': 17, 'minutes': 45, 'seconds': 41.52}\", 4.82], [1, 3, \"2025-03-10 {'degrees': 13, 'minutes': 25, 'seconds': 17.62}\", 4.31], [1, 8, \"2025-03-14 {'degrees': 20, 'minutes': 54, 'seconds': 24.65}\", 1.78], [1, 5, \"2025-03-16 {'degrees': 15, 'minutes': 31, 'seconds': 6.37}\", 5.07], [1, 0, \"2025-03-21 {'degrees': 17, 'minutes': 15, 'seconds': 57.0}\", 1.52], [2, 2, \"2025-03-23 {'degrees': 5, 'minutes': 47, 'seconds': 24.19}\", 1.24], [2, 7, \"2025-03-24 {'degrees': 11, 'minutes': 37, 'seconds': 5.39}\", 3.2], [2, 4, \"2025-03-27 {'degrees': 16, 'minutes': 19, 'seconds': 8.49}\", 2.84], [2, 6, \"2025-03-30 {'degrees': 12, 'minutes': 29, 'seconds': 51.24}\", 3.37], [2, 3, \"2025-04-02 {'degrees': 21, 'minutes': 27, 'seconds': 34.51}\", 3.02], [2, 8, \"2025-04-05 {'degrees': 21, 'minutes': 53, 'seconds': 57.43}\", 1.24], [2, 5, \"2025-04-07 {'degrees': 3, 'minutes': 43, 'seconds': 38.64}\", 3.55], [2, 0, \"2025-04-10 {'degrees': 16, 'minutes': 57, 'seconds': 2.07}\", 1.07], [2, 1, \"2025-04-11 {'degrees': 18, 'minutes': 31, 'seconds': 3.11}\", 1.78], [7, 7, \"2025-04-13 {'degrees': 13, 'minutes': 7, 'seconds': 44.83}\", 8.22], [7, 4, \"2025-04-21 {'degrees': 18, 'minutes': 21, 'seconds': 35.64}\", 7.3], [7, 6, \"2025-04-29 {'degrees': 1, 'minutes': 40, 'seconds': 34.15}\", 8.67], [7, 3, \"2025-05-07 {'degrees': 17, 'minutes': 51, 'seconds': 51.12}\", 7.76], [7, 8, \"2025-05-15 {'degrees': 12, 'minutes': 8, 'seconds': 15.78}\", 3.2], [7, 5, \"2025-05-18 {'degrees': 16, 'minutes': 50, 'seconds': 18.88}\", 9.13], [7, 0, \"2025-05-27 {'degrees': 19, 'minutes': 59, 'seconds': 2.01}\", 2.74], [7, 1, \"2025-05-30 {'degrees': 13, 'minutes': 43, 'seconds': 38.95}\", 4.57], [7, 2, \"2025-06-04 {'degrees': 3, 'minutes': 18, 'seconds': 0.51}\", 3.2], [4, 4, \"2025-06-07 {'degrees': 8, 'minutes': 0, 'seconds': 3.61}\", 6.49], [4, 6, \"2025-06-13 {'degrees': 19, 'minutes': 50, 'seconds': 15.61}\", 7.71], [4, 3, \"2025-06-21 {'degrees': 12, 'minutes': 53, 'seconds': 37.37}\", 6.9], [4, 8, \"2025-06-28 {'degrees': 10, 'minutes': 28, 'seconds': 12.62}\", 2.84], [4, 5, \"2025-07-01 {'degrees': 6, 'minutes': 38, 'seconds': 55.37}\", 8.12], [4, 0, \"2025-07-09 {'degrees': 9, 'minutes': 26, 'seconds': 40.38}\", 2.43], [4, 1, \"2025-07-11 {'degrees': 19, 'minutes': 52, 'seconds': 59.88}\", 4.06], [4, 2, \"2025-07-15 {'degrees': 21, 'minutes': 16, 'seconds': 52.38}\", 2.84], [4, 7, \"2025-07-18 {'degrees': 17, 'minutes': 27, 'seconds': 35.13}\", 7.3], [6, 6, \"2025-07-26 {'degrees': 0, 'minutes': 46, 'seconds': 33.64}\", 9.16], [6, 3, \"2025-08-04 {'degrees': 4, 'minutes': 31, 'seconds': 48.22}\", 8.19], [6, 8, \"2025-08-12 {'degrees': 9, 'minutes': 9, 'seconds': 7.59}\", 3.37], [6, 5, \"2025-08-15 {'degrees': 18, 'minutes': 6, 'seconds': 50.85}\", 9.64], [6, 0, \"2025-08-25 {'degrees': 9, 'minutes': 26, 'seconds': 3.05}\", 2.89], [6, 1, \"2025-08-28 {'degrees': 6, 'minutes': 49, 'seconds': 48.7}\", 4.82], [6, 2, \"2025-09-02 {'degrees': 2, 'minutes': 29, 'seconds': 24.8}\", 3.37], [6, 7,"
}Captured from a real call using the exact request above. Results sit under data, keyed by what you requested.
Errors
Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.