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. Aspects are full Parashari graha drishti counted from the aspecting planet's sign (Mars 4/7/8, Jupiter 5/7/9, Saturn 3/7/10, Rahu 7); house lords are whole sign from the lagna. A Jupiter or Venus aspect or conjunction cancels Mangal Dosha only when that planet is strong — not debilitated and not combust; one that does not count is listed in mangal_dosha.details.benefic_aspects_not_counted.

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 (unless utc_offset is given). For dates before the zone adopted a standard time, the birthplace's local mean time (longitude / 15 hours) is used.

utc_offsetoptional

string | null

Optional explicit UTC offset of the birth time, as ±HH:MM or ±HH:MM:SS (e.g. '+04:51:31' for Bombay mean time). Overrides the offset timezone would give. Use it when the birth record states the offset, or for historical local times the IANA database cannot represent.

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

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

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": [],
          "benefic_aspects_not_counted": [
            "Jupiter aspects or conjoins Mars but is debilitated — not strong enough to cancel"
          ],
          "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; Sun aspected by Rahu",
          "factors": [
            "Sun debilitated",
            "Sun conjunct Saturn",
            "... and 1 more item"
          ]
        },
        "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.76728729946245,
          "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
  }
}