POST/v1/astro/dosha

Calculate dosha report

Detect all major Vedic doshas in a natal chart — Mangal Dosha, Kaal Sarp Dosha, Gandmool, Grahan, Guru Chandal, Kemdrum, Shrapit, and Pitru Dosha. Present doshas include cancellation analysis, classical interpretation, keywords, and traditional remedies.

Request parameters

locationoptional

string | null

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

nameoptional

string

Person name associated with the birth record

daterequired

string

Birth date in YYYY-MM-DD format

timeoptional

string | null

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.

latitudeoptional

number | null

Latitude. Required if location not provided.

longitudeoptional

number | null

Longitude. Required if location not provided.

timezoneoptional

string | null

IANA timezone. Required if location not provided.

ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.doshas

object

data.birth_time_provided

boolean

Whether a precise birth time was provided. False when birth time was not supplied or treated as unknown — calculations using this field will have lagna-dependent accuracy limits.

Errors

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

API key tier does not include this endpoint.

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

• Ghat Chakra
• Pitru Dosha (Pitru Shapa)
• Sade Sati periods
• Calculate yoga combinations

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/astro/dosha" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1985-11-12","time":"06:45","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata"}'

Python

import asterwise
from asterwise.api.astrology_api import AstrologyApi
from asterwise.models.dosha_request import DoshaRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = DoshaRequest(
    date="1985-11-12",
    time="06:45",
    latitude=19.076,
    longitude=72.8777,
    timezone="Asia/Kolkata",
)

with asterwise.ApiClient(configuration) as client:
    api = AstrologyApi(client)
    result = api.doshas(dosha_request=request)
    print(result)

TypeScript

import { createClient, createConfig, doshas } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await doshas({
  client,
  body: {
      "date": "1985-11-12",
      "time": "06:45",
      "latitude": 19.076,
      "longitude": 72.8777,
      "timezone": "Asia/Kolkata"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "doshas": {
      "mangal_dosha": {
        "present": true,
        "types": [],
        "details": {
          "mars_house": 12,
          "from_moon": true,
          "moon_house": 12,
          "from_venus": true,
          "venus_house": 12,
          "d9_present": false,
          "reference_points": [
            "Lagna",
            "Moon",
            "... and 1 more item"
          ],
          "severity": "medium",
          "cancellations": [],
          "description": "Mars in qualifying houses from Lagna/Moon/Venus (D1) — Mangal Dosha.",
          "retrograde_potency": false
        },
        "interpretation_summary": "Mangal Dosha indicates that Mars's intensity requires conscious management in the domain of partnership and marriage. Ma…",
        "keywords": [
          "marriage conflict",
          "partner harmony",
          "... and 1 more item"
        ],
        "remedies": [
          "Marry a Manglik partner",
          "Kumbh Vivah — symbolic first marriage to a tree or idol",
          "... and 4 more items"
        ]
      },
      "shani_dosha": {
        "present": true,
        "types": [],
        "details": {
          "natal_afflicted": true,
          "natal_saturn_affliction": true,
          "affliction_conditions": [
            "Saturn combust"
          ],
          "saturn_dignity": "neutral",
          "saturn_house": 2,
          "sade_sati_note": "Transit-based — see Gochar endpoint",
          "sade_sati_from_natal": false
        },
        "interpretation_summary": "Shani Dosha indicates Saturn's karmic weight pressing on sensitive areas of the natal chart — the 1st, 4th, 7th, 8th, or…",
        "keywords": [
          "karmic delays",
          "hardship",
          "... and 4 more items"
        ],
        "remedies": [
          "Worship Lord Shani on Saturdays",
          "Light sesame oil lamp on Saturday evenings",
          "... and 5 more items"
        ]
      },
      "shrapit_dosha": {
        "present": false,
        "types": [],
        "details": {},
        "interpretation_summary": null,
        "keywords": null,
        "remedies": null
      },
      "grahan_dosha": {
        "present": true,
        "types": [
          "Surya Grahan Dosha (Ketu)",
          "Chandra Grahan Dosha (Ketu)"
        ],
        "details": {
          "description": "Surya Grahan Dosha (Ketu) • Chandra Grahan Dosha (Ketu)",
          "source_tier": "External"
        },
        "interpretation_summary": "Grahan Dosha places one of the two luminaries — Sun or Moon — under the eclipse effect of Rahu or Ketu, and the result i…",
        "keywords": [
          "eclipsed luminaries",
          "shadow filter",
          "... and 1 more item"
        ],
        "remedies": [
          "For Sun-Rahu: Surya Namaskar at sunrise, donate wheat on Sundays",
          "For Sun-Ketu: Worship Lord Ganesha, donate sesame seeds",
          "... and 2 more items"
        ]
      },
      "kala_sarpa": {
        "present": false,
        "types": [],
        "details": {},
        "interpretation_summary": null,
        "keywords": null,
        "remedies": null
      },
      "guru_chandal": {
        "present": false,
        "types": [],
        "details": {},
        "interpretation_summary": null,
        "keywords": null,
        "remedies": null
      },
      "kemadruma_dosha": {
        "present": false,
        "types": [],
        "details": {
          "cancellations": [
            "Planet conjunct Moon"
          ]
        },
        "interpretation_summary": null,
        "keywords": null,
        "remedies": null
      },
      "paap_kartari": {
        "present": true,
        "types": [],
        "details": {
          "lagna": true,
          "chandra": true,
          "per_house_flags": {
            "1": true,
            "2": false,
            "3": false,
            "4": false,
            "5": false,
            "6": false,
            "7": false,
            "8": false,
            "9": false,
            "10": false,
            "11": false,
            "12": false
          },
          "notes": [
            "H1 hemmed"
          ]
        },
        "interpretation_summary": "Paap Kartari Dosha creates a constricting pressure on whichever house sits between the malefic scissors — the Lagna or t…",
        "keywords": [
          "constriction",
          "hemmed ascendant",
          "... and 4 more items"
        ],
        "remedies": [
          "Strengthen the Lagna lord through its specific planetary remedies",
          "Recite mantras of benefic planets Jupiter and Venus to attract their protective aspect",
          "... and 3 more items"
        ]
      },
      "pitru_dosha": {
        "present": true,
        "types": [],
        "details": {
          "description": "Sun debilitated; Sun conjunct Saturn; 9th lord (Mercury) aspected by Rahu; 9th lord (Mercury) aspected by Saturn",
          "factors": [
            "Sun debilitated",
            "Sun conjunct Saturn",
            "... and 2 more items"
          ]
        },
        "interpretation_summary": "Pitru Dosha operates as ancestral karma that has not been resolved within the family lineage and therefore continues to…",
        "keywords": [
          "ancestral karma",
          "family patterns",
          "... and 2 more items"
        ],
        "remedies": [
          "Pitru Tarpan on Amavasya (new moon) and Pitru Paksha",
          "Shradh ceremonies on death anniversaries of ancestors",
          "... and 3 more items"
        ]
      },
      "gandmool_dosha": {
        "present": false,
        "types": [],
        "details": {},
        "interpretation_summary": null,
        "keywords": null,
        "remedies": null
      },
      "nadi_dosha": {
        "present": false,
        "types": [],
        "details": {
          "note": "Pair-based. See calculate_nadi_dosha_pair."
        },
        "interpretation_summary": null,
        "keywords": null,
        "remedies": null
      },
      "gulika": {
        "present": false,
        "types": [],
        "details": {
          "longitude": 284.7639023331403,
          "sign_index": 9,
          "sign_name": "Makara",
          "house": 4,
          "dosha_sensitive": false,
          "portion_1based": 5
        },
        "interpretation_summary": null,
        "keywords": null,
        "remedies": null
      }
    },
    "birth_time_provided": true
  }
}