/api/astro/dosha/1 creditDoshas
A dosha is a specific affliction in a birth chart — a named planetary configuration that classical texts treat as a liability, most often for marriage, health or the ancestral line. This endpoint tests for eight of them from the birth moment and place, and can return either the bare results or ready-to-display written explanations. There are two ways to use it. The individual keys (`kala_sarpa`, `manglik`, `pitru_dosha` and the rest) return structured results you can act on in code. `get_dosha_details` returns the whole set as formatted HTML paragraphs keyed by the English dosha name, which is what you want if you are rendering a report; it covers Kala Sarpa, Manglik, Pitru, Guru Chandala, Kalathra, Ghata and Shrapit, but not Ganda Moola. `get_dosha_resources` gives you the underlying text corpus if you would rather assemble your own copy. All the boolean and structured request fields are required by the serializer even for keys that ignore them. `manglik_reference_planet` is a planet index (0 Sun, 1 Moon, 2 Mars, 3 Mercury, 4 Jupiter, 5 Venus, 6 Saturn, 7 Rahu, 8 Ketu); the engine's own default of measuring from the ascendant cannot be selected through the API, because the field is typed as an integer. This endpoint calls the UTC offset field `timezone`, not `timezone_as_float`.
https://yogataraapi.prahlad.app/api/astro/dosha/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 |
|---|---|---|---|
| apply_exceptions | boolean | required | |
| 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. FORMAT constraint. DRF DateTimeField: ISO-8601 only (DRF default input formats), e.g. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" or "2026-09-01 06:00:00" (no timezone = UTC assumed). |
| include_2nd_house | boolean | required | |
| include_lagna_house | 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. get_dosha_resourceskala_sarpamanglikpitru_doshaguru_chandala_doshakalathraganda_moolaghatashrapitget_dosha_detailsArray of strings. 'manglik' requires manglik_reference_planet, include_lagna_house, include_2nd_house and apply_exceptions; 'ganda_moola' requires moon_star; 'get_dosha_details' requires date_time and geopos. |
| 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 |
| manglik_reference_planet | integer | required | |
| moon_star | string | required | Semantically a nakshatra NUMBER 1-27 (the Ganda Moola nakshatras being 1 Ashwini, 9 Ashlesha, 10 Magha, 18 Jyeshtha, 19 Moola, 27 Revati). No working accepted-value list can be published until that type mismatch is fixed. |
| 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 (10)
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 |
|---|---|---|
| ganda_moola | moon_star | Ganda Moola: whether the birth star is one of the six junction nakshatras (Ashwini, Ashlesha, Magha, Jyeshtha, Moola, Revati). It is meant to take the nakshatra number 1–27 in `moon_star` and return a boolean, but the field is typed as a string while the comparison list holds integers, so as it stands the key returns false for every input. |
| get_dosha_details | date_time, geopos | All seven of the narrative doshas evaluated and written up at once: an object keyed by the English dosha name — Kala Sarpa Dosha, Manglik Dosha, Pitru Dosha, Guru Chandala Dosha, Kalathra Dosha, Ghata Dosha and Shrapit Dosha — whose values are HTML fragments saying whether the dosha is present and what it means. Ganda Moola is not included. Requires `date_time` and the place. |
| get_dosha_resources | — | The full corpus of dosha explanation text, as an object keyed by dosha name ('kala_sarpa', 'manglik', 'pitru', 'ghata' and so on) with a list of English paragraphs under each. The first entry of a list is the 'no such dosha' wording and the later entries correspond to the house or variety involved. Use it to render your own copy rather than the pre-assembled HTML. |
| ghata | — | Ghata Dosha: Mars and Saturn together in the same sign. Returns a single boolean. |
| guru_chandala_dosha | — | Guru Chandala: Jupiter conjunct Rahu or Ketu in the same sign. Returns a two-element list of [whether the combination is present, whether Jupiter is the stronger of the two]. Both are false when there is no conjunction. |
| kala_sarpa | — | Kala Sarpa Dosha: true when all seven classical planets are hemmed between Rahu and Ketu on one side of the nodal axis. Returns a single boolean; the variety (Ananta, Kulika, Vasuki and so on) follows from the house Rahu occupies. |
| kalathra | — | Kalathra Dosha, the affliction of the marriage house. True when every natural malefic — Sun, Mars, Saturn, Rahu and Ketu — falls in the 1st, 2nd, 4th, 7th, 8th or 12th counted from the seventh house. Returns a single boolean, and because it requires all five malefics to qualify it is rarely true. |
| manglik | manglik_reference_planet, include_lagna_house, include_2nd_house, apply_exceptions | Manglik, or Mangal Dosha: whether Mars falls in one of the houses that afflict marriage, counted from `manglik_reference_planet`. Returns a three-element list of [is manglik, whether a cancellation applies, the numbers of the cancellation rules that matched]. The houses tested are the 4th, 7th, 8th and 12th, plus the 2nd when `include_2nd_house` is true and the 1st when `include_lagna_house` is true; cancellations are only evaluated when `apply_exceptions` is true. |
| pitru_dosha | — | Pitru Dosha, the affliction of the ancestral line. Returns a two-element list of [true or false, the numbers of the rules that triggered]. Five rules are tested in order: a luminary or Rahu in the 9th, Ketu in the 4th, Sun/Moon/Rahu/Ketu afflicted by Mars or Saturn, a crowding of Mercury, Venus and Rahu in the 2nd, 5th, 9th or 12th, and Sun or Moon conjunct a node. |
| shrapit | — | Shrapit Dosha: Saturn and Rahu together in the same sign. Returns a single boolean. |
Example request
curl -X POST https://yogataraapi.prahlad.app/api/astro/dosha/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_dosha_resources"],"date_time":"2025-07-11T04:37:08.718Z","latitude":26.9124,"longitude":75.7873,"timezone":0,"manglik_reference_planet":0,"include_lagna_house":true,"include_2nd_house":true,"apply_exceptions":true,"moon_star":"leo"}'Response
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"get_dosha_resources\": {\"kala_sarpa\": [\"There is no Kala Sarpa Dosha in this horoscope.\", \"Ananta Kala Sarpa Dosha- Rahu in 1st House and Ketu in 7th House. In this Dosha, Rahu is placed in the 1st house and Ketu in the 7th house in the horoscope. All planets are placed between Rahu-Ketu from the 1st house to the 7th house. This alignment can make a person ill-tempered and bring health issues. There would be problems in marital relationships, and, if in business, there would be a lack of support from partners.\", \"Kulik Kala Sarpa Dosha- Rahu in 2nd House and Ketu in 8th House. This Dosha is formed when Rahu is in the 2nd house and Ketu is in the 8th house, and all planets are between them. The individual afflicted may be vile-tongued and lead a life without the support of relatives. Monetary problems might surface, and savings might not be possible. The afflicted native may undergo surgery or accidents. There may be a possibility of unnatural death.\", \"Vasuki Kala Sarpa Dosha- Rahu in 3rd House and Ketu in 9th House. This Dosha is formed in the horoscope when Rahu and Ketu are in the 3rd, and 9th houses, respectively, and the remaining planets are hemmed between them. The afflicted individual may be timid in disposition and unable to fight for self-esteem. Relationships with younger siblings might not be good. Tide will go against the individual who may be unable to overcome adversity. The native can lack interest in religion, and luck may not favor them.\", \"Shankapal Kala Sarpa Dosha- Rahu in 4th House and Ketu in 10th House. This Dosha is formed when all planets are between Rahu and Ketu, which are placed from the 4th house to the 10th house. This alignment causes the native to have a bad relationship with the mother. The individual might not have mental peace and face professional problems.\", \"Padma Kala Sarpa Dosha- Rahu in 5th House and Ketu in 11th House. The axis of Rahu-Ketu from the 5th house to the 11th house and all planets within this axis cause this Dosha. The afflicted individual can face an issue with childbirth and education. They may have problems earning and may get into conflict with elder siblings.\", \"Mahapadma Kala Sarpa Dosha- Rahu in 6th House and Ketu in 12th House. The alignment of all planets in the Rahu-Ketu axis of the 6th house to the 12th house causes this Dosha. The afflicted individual can be dominated by enemies and lose money and property. The native could waste money, be unpopular, and have conflicts with in-laws.\", \"Takshak Kala Sarpa Dosha- Rahu in 7th House and Ketu in 1st House. The placement of all planets in the axis of Rahu-Ketu from the 7th house to the 1st house cause this Dosha. The afflicted may not go through marriage. If married, then the marriage might not go well. This Dosha can create a rift between the couple, leading to separation.\", \"Karakotak Kala Sarpa Dosha- Rahu in 8th House and Ketu in 2nd House. The placement of Rahu in the 8th house and Ketu in the 2nd house and the remaining planets in between them can cause this Dosha. The afflicted native might be ill-tempered and befriend anti-social elements. The native might have enemies and not be granted paternal wealth.\", \"Shankachood Kala Sarpa Dosha- Rahu in 9th House and Ketu in 3rd House. When Rahu is placed in the 9th house, Ketu in the 3rd house and all planets are between Rahu and Ketu; this Dosha is created in the horoscope. An afflicted individual might struggle a lot in life, and luck may never favor them. The individual may develop a habit of lying constantly and could be short-tempered.\", \"Ghatak Kala Sarpa Dosha- Rahu in 10th House and Ketu in 4th House. This Dosha is formed when Rahu is placed in the 10th house, Ketu in the 4th house, and all the planets are between the 10th to 4th houses. The afflicted individual may face many hurdles in his profession and conflicts with superiors at work. The individual may lack focus and face criticism. Relationships with family members may be poor. There may be de"
}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.