/api/astro/raja_yoga/1 creditRaja yogas
A raja yoga is a combination in a birth chart said to confer status and success. The core case is an association between the lord of an angular house (1, 4, 7, 10) and the lord of a trine (1, 5, 9) — the two conjoined, aspecting each other, or exchanging signs. This endpoint checks the three named variants the engine implements: Vipareeta raja yoga (the lords of the difficult sixth, eighth and twelfth houses falling among themselves), Neecha Bhanga raja yoga (a debilitated planet whose debilitation is cancelled) and Dharma-Karmadhipati raja yoga (the ninth and tenth lords in association). One key, `get_raja_yoga_details_for_all_charts`, which runs the checks across every divisional chart the engine knows rather than the birth chart alone. Its value is a three-element array: an object mapping each yoga found to its details, the number found, and the number of checks made — three yoga types across twenty-three divisional charts, so 69. Each detail entry is a list of strings: first a line naming the divisional chart and the planet pairs responsible, such as `"D1-Raja Yoga Pairs: [Viyaazhan-Sani]"`, then the yoga's name, its definition and its predicted effects. Two notes on reading the output. Planet names inside the pairs line are given in Tamil transliteration whatever else you send: Suriyan is the Sun, Chandran the Moon, Sevvay Mars, Budhan Mercury, Viyaazhan Jupiter, VeLLi Venus and Sani Saturn. And because the results from all divisional charts are merged into one object keyed by yoga name, each yoga appears once only, reported against the earliest divisional chart in which it was found — a `D4-` prefix means the birth chart itself did not have it. One caveat before you build on this: the underlying calculation currently substitutes a fixed date for the `date_time` you send, so the result responds to the location fields but not to the birth date. Check it against a chart you know before relying on it.
https://yogataraapi.prahlad.app/api/astro/raja_yoga/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. |
| 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 | 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. |
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 |
|---|---|---|
| get_raja_yoga_details_for_all_charts | — | Scans every divisional chart for the three raja yoga variants the engine implements — Vipareeta, Neecha Bhanga and Dharma-Karmadhipati. Returns a three-element array: an object keyed by yoga name holding that yoga's details, the count found, and the number of checks made (69, being three yoga types across twenty-three charts). Each detail value is a list of strings — the divisional chart and responsible planet pairs, then the yoga's name, definition and effects — and because the charts' results are merged into one object, a yoga appears once only, against the earliest chart in which it was found. |
Example request
curl -X POST https://yogataraapi.prahlad.app/api/astro/raja_yoga/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_raja_yoga_details_for_all_charts"],"date_time":"2025-07-14T11:00:37.673Z","latitude":13,"longitude":77.5946,"timezone":5.5}'Response
{
"data": {
"get_raja_yoga_details_for_all_charts": [
{
"vipareetha_raja_yoga": [
"D1-Raja Yoga Pairs: [Viyaazhan-Sani] [Viyaazhan-VeLLi] ",
"Vipareetha Raja yoga",
"The 6th, 8th and 12th houses are known as trik sthanas or dusthanas (bad houses). If their lords occupies dusthanas or conjoin dusthanas, it results in this yoga.",
"One having this yoga experiences tremedous success, typically after an initial struggle. Vipareeta means extreme."
],
"neecha_bhanga_raja_yoga": [
"D4-Raja Yoga Pairs: [Sevvay-Sani] [Sevvay-VeLLi] ",
"Neecha Bhanga Raja yoga",
"1. If the lord of the sign occupied by a weak or debilitated planet is exalted or is in Kendra from Moon. Ex, If Jupiter is debilitated in Capricorn and if Saturn is exalted and placed in Kendra from moon. 2. If the debilitated planet is conjunct with the Exalted Planet. 3. If the debilitated planet is aspected by the master of that sign. Ex, If Sun is debilitated in Libra and it is aspect by Venus with 7th aspect. 4. If the debilitated planet is Exalted in Navamsa Chart. 5. The planet which gets exalted in the sign where a debilitated planet is placed is in a Kendra from the Lagna or the Moon. Ex, If Sun is debilitated in the birth chart in Libra and Saturn which gets exalted in Libra is placed in Kendra from Lagna or Moon. NOTE: Checks only the first 3 conditions below. 4 and 5 to be done in future version",
"Neecha Bhanga Raja Yoga provides one with Fame, Property, and Control usually. But all the said prosperities will be used by the native only in the next half of life particularly after the age 36 corresponding to the age at the yoga developing dasha, sub-period and transits take place in one’s chart. This typical nature is attributed to this Yoga because the planet who create Neecha Bhanga Rajayoga is subjected to debilitation first and then attains the cancellation. Likewise, the native's life too would suffer adversities in the initial part of life and then will start excelling. Earning from multiple sources and earning a good reputation from a vast number of peoples and various communities along with holding a good image is the result of this Yoga. One will be admired within his/her personal, professional and social circles. Whatever they do brings a good reputation for them and people usually like them for what they are. They will gather huge property and start producing many sources of income once the Rajayoga is in operation. They will also hold power in life. The native will be holding power over many people once this Yoga is operational."
],
"dharma_karmadhipati_raja_yoga": [
"D1-Raja Yoga Pairs: [Viyaazhan-Sani] ",
"Dharma Karmadhipati Raja yoga",
"If the lords of dharma sthana (9th) and karma sthana (10th) form a raja yoga, it is known by this special name. The 9th house is the most important trine and the 10th house is the most important quadrant.",
"One born with this yoga is sincere, devoted and righteous. He is fortunate."
]
},
3,
69
]
},
"status": 200,
"is_error": false,
"message": "successful"
}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.