Doshas - planetary afflictions

Doshas are planetary afflictions in a natal chart that classically indicate risks, restrictions, or karmic debts. AstroWay covers 19 dosha endpoints across three schools - Parashara (classical, 7 endpoints), Lal Kitab (North-Indian oral tradition, 6) and KP (Krishnamurti Paddhati, 6).

Caution

Dosha interpretation is culturally sensitive. We return a computational result (present/absent + strength), not a verdict on someone’s life. How you surface this in UI is up to the integrator. We recommend balancing “this dosha is present” with context about remedies and the fact that classical texts describe ~80% of charts as having at least one dosha.

What we compute

• Manglik dosha (Mars affliction): Mars in houses 1/2/4/7/8/12 from ascendant, Moon, or Venus. The most important dosha for marriage in Indian tradition.
• Kaal Sarp dosha: all 7 planets between Rahu and Ketu (“in the snake’s mouth”). Multiple sub-variants (Anant, Kulik, Vasuki, Shankhpal, Padma, Mahapadma, Takshak, Karkotak, Shankhachud, Ghatak, Vishdhar, Sheshnag) depending on which Rahu-Ketu axis houses are involved.
• Pitru dosha: Sun or Rahu afflicted; classically a karmic debt to ancestors.
• Shrapit dosha: Saturn and Rahu conjunct in any house; “curse” from past life.
• Grahan dosha: Sun/Moon conjunct Rahu or Ketu.
• Guru-Chandal dosha: Jupiter with Rahu (chandal = “lawless” Rahu corrupts Guru).
• Lal Kitab doshas: manglik with the LK cancellation (Mars in its own sign or in pakka ghar), kalsarpa, pitra (ancestral debt), rin (all six debts in one call), shrapit (Saturn with Rahu or Ketu).
• KP doshas: diagnosed via Krishnamurti sub-lord theory, plus sade-sati (Saturn transit, takes targetDate) and kemadruma (an isolated Moon).

Endpoints

Endpoint	School	Credits	Description
/v1/vedic/doshas/parashara/mangal	Parashara	20	Manglik dosha
/v1/vedic/doshas/parashara/kaal-sarp	Parashara	20	Kaal Sarp + variant
/v1/vedic/doshas/parashara/pitru	Parashara	20	Pitru dosha
/v1/vedic/doshas/parashara/shrapit	Parashara	20	Shrapit dosha
/v1/vedic/doshas/parashara/grahan	Parashara	20	Grahan dosha
/v1/vedic/doshas/parashara/guru-chandal	Parashara	20	Guru-Chandal dosha
/v1/vedic/doshas/parashara/full	Parashara	20	Every Parashara dosha
/v1/vedic/doshas/lal-kitab/manglik	Lal Kitab	20	Manglik per Lal Kitab, with the LK cancellation
/v1/vedic/doshas/lal-kitab/kalsarpa	Lal Kitab	20	Kaal Sarp per Lal Kitab
/v1/vedic/doshas/lal-kitab/pitra	Lal Kitab	20	Pitri rin, the ancestral debt
/v1/vedic/doshas/lal-kitab/rin	Lal Kitab	20	All six rin and how many are active
/v1/vedic/doshas/lal-kitab/shrapit	Lal Kitab	20	Saturn with Rahu or Ketu
/v1/vedic/doshas/lal-kitab/full	Lal Kitab	20	Every Lal Kitab dosha
/v1/vedic/doshas/kp/manglik	KP	20	Manglik with the Mars sub-lord chain
/v1/vedic/doshas/kp/kalasarpa	KP	20	Kaal Sarp per KP
/v1/vedic/doshas/kp/pitra	KP	20	Pitru with the Sun sub-lord chain
/v1/vedic/doshas/kp/sade-sati	KP	20	Sade Sati, Saturn’s transit on targetDate
/v1/vedic/doshas/kp/kemadruma	KP	20	Kemadruma: a Moon with no neighbours
/v1/vedic/doshas/kp/full	KP	20	Every KP dosha

Example

cURL

curl -X POST https://api.astroway.info/v1/vedic/doshas/parashara/full \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234,
    "ayanamsa": "lahiri"
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/vedic/doshas/parashara/full', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
    ayanamsa: 'lahiri',
  }),
});
const { data } = await r.json();
const DOSHAS = ['mangal', 'kaalSarp', 'pitru', 'shrapit', 'grahan', 'guruChandal'];
for (const key of DOSHAS) {
  const d = data[key];
  console.log(`${key}: ${d.present ? 'YES' : 'no'} (${d.severity})`);
  for (const line of d.details) console.log(`  ${line}`);
}

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/vedic/doshas/parashara/full',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
    json={
        'date': '1990-07-14',
        'time': '14:30:00',
        'timezoneOffset': 3,
        'latitude': 50.4501,
        'longitude': 30.5234,
        'ayanamsa': 'lahiri',
    },
)
data = r.json()['data']
for key in ('mangal', 'kaalSarp', 'pitru', 'shrapit', 'grahan', 'guruChandal'):
    d = data[key]
    print(f"{key}: {'YES' if d['present'] else 'no'} ({d['severity']})")
    for line in d['details']:
        print(f"  {line}")

Sample response (abbreviated):

{
  "data": {
    "school": "parashara",
    "lagnaSign": 6,
    "mangal": {
      "present": false,
      "severity": "none",
      "affectedHouses": [],
      "contributingPlanets": [{ "graha": 4, "planetName": "Mars", "sign": 0, "house": 7 }],
      "details": ["Mars in own/exalted sign (sign 1): Mangal Dosha cancelled"]
    },
    "kaalSarp": {
      "present": false,
      "subType": null,
      "partial": true,
      "severity": "mild",
      "affectedHouses": [4, 10],
      "contributingPlanets": [],
      "details": ["Partial Kaal Sarp: 6 of 7 grahas on one side (6 Rahu-side, 1 Ketu-side)"]
    },
    "pitru": {
      "present": false,
      "severity": "none",
      "affectedHouses": [],
      "contributingPlanets": [{ "graha": 0, "planetName": "Sun", "sign": 2, "house": 9 }],
      "details": ["Sun in 9th house from lagna: paternal lineage focus"]
    }
  }
}

Accuracy and sources

• Parashara doshas: Brihat Parashara Hora Shastra, cross-checked against Phaladeepika and Saravali. Manglik uses the most classical formulation (Mars in 1/2/4/7/8/12 with cancellation rules).
• Lal Kitab: Lal Kitab (Pandit Roop Chand Joshi, 1939-1952, 5 volumes). Doshas in this school have a different logic (planet-house themes, “teen rin” - three debts, varshphal cycle); they don’t map 1:1 onto classical Parashara.
• KP: Krishnamurti Paddhati readers (K.S. Krishnamurti, 6 volumes). Sub-lord theory, distinct from Parashara cusp work.
• Status: Parashara GREEN; Lal Kitab mostly YELLOW (single-author lineage, minimal cross-verification across commercial APIs), and every response from that school carries its own disclaimer. Full trail in docs/AUDIT-TRAIL.md.

Related

Yogas Raja, Dhana, Mahapurusha - 15 combination endpoints

Compatibility Manglik match, Ashtakoot, Dashakoota

Muhurat Electional astrology for events

Credits Per-endpoint credit cost

Accuracy How we verify calculations

Authentication X-Api-Key, sandbox keys