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 four schools — Parashara (classical), Lal Kitab (North-Indian oral tradition), KP (Krishnamurti Paddhati) and Jaimini.

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, kaal-sarp, pitru-rin (ancestral debt as one of 7 rin), kaal-purush variant per Lal Kitab specifics.
• KP doshas — diagnosed via Krishnamurti sub-lord theory.
• Jaimini doshas — arudha afflictions and badhaka pattern.

Endpoints

Endpoint	School	Credits	Description
/v1/vedic/doshas/parashara/mangal	Parashara	20	Manglik dosha
/v1/vedic/doshas/parashara/kaal-sarp	Parashara	20	Kaal Sarp + sub-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	50	All Parashara doshas
/v1/vedic/doshas/lal-kitab/manglik	Lal Kitab	20	Manglik per Lal Kitab
/v1/vedic/doshas/lal-kitab/kaal-sarp	Lal Kitab	20	Kaal Sarp per Lal Kitab
/v1/vedic/doshas/lal-kitab/pitru-rin	Lal Kitab	20	Ancestral debt
/v1/vedic/doshas/lal-kitab/kaal-purush	Lal Kitab	20	Kaal Purush dosha
/v1/vedic/doshas/lal-kitab/full	Lal Kitab	50	All Lal Kitab doshas
/v1/vedic/doshas/kp/mangal	KP	20	Manglik via KP sub-lord
/v1/vedic/doshas/kp/kaal-sarp	KP	20	Kaal Sarp via KP
/v1/vedic/doshas/kp/full	KP	50	All KP doshas
/v1/vedic/doshas/jaimini/arudha-affliction	Jaimini	20	Arudha pada affliction
/v1/vedic/doshas/jaimini/badhaka	Jaimini	20	Badhaka pattern
/v1/vedic/doshas/jaimini/full	Jaimini	50	All Jaimini doshas
/v1/vedic/doshas/all	All	100	All four schools grouped

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();
for (const d of data.doshas) {
  console.log(`${d.name}: ${d.present ? 'YES' : 'no'} (${d.strength ?? '-'})`);
}

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',
    },
)
for d in r.json()['data']['doshas']:
    verdict = 'YES' if d['present'] else 'no'
    print(f"{d['name']}: {verdict} ({d.get('strength', '-')})")

Sample response (abbreviated):

{
  "data": {
    "doshas": [
      {
        "name": "Mangal Dosha",
        "key": "mangal",
        "present": true,
        "strength": "moderate",
        "reason": "Mars in 7th house from Ascendant",
        "cancellations": ["Mars in own sign"],
        "net_effect": "partial"
      },
      {
        "name": "Kaal Sarp Dosha",
        "key": "kaal-sarp",
        "present": false
      }
    ],
    "ayanamsa": "lahiri"
  }
}

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.
• Jaimini — Jaimini Sutras; arudha-pada afflictions.
• Status — Parashara GREEN; Lal Kitab and Jaimini mostly YELLOW (single-author lineage, minimal cross-verification across commercial APIs). Honest disclaimer kept in docs/AUDIT-TRAIL.md.

Related

Yogas Raja, Dhana, Mahapurusha — 12 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