/v1/milan/mangal-dosha

Mangal Dosha with cancel rules.

What this tells you

Mangal (Kuja) Dosha occurs when Mars is placed in specific houses in a natal chart — classically considered inauspicious for marriage longevity. Many cancellation rules exist: Mars in own sign (Aries/Scorpio) or in Capricorn cancels; both partners having Mangal Dosha cancels. In practice, most modern astrologers treat it as a caution rather than a strict prohibition.

Request

All requests require an Authorization header with your dv_live_* API key.

example request

curl "https://api.divyastroapi.com/v1/milan/mangal-dosha?date=2026-04-19&time=06%3A30&tz=%2B05%3A30&lat=28.61&lon=77.21" \
  -H "Authorization: Bearer dv_live_0123456789abcdef0123456789abcdef"

Response (200 OK)

Successful requests return a JSON body. Field names are stable across versions.

200 response

{
  "boy": {
    "has_mangal_dosha": true,
    "mars_house": 8,
    "dosha_type": "Kuja Dosha (Severe)",
    "cancellations": ["Mars in own sign"]
  },
  "girl": {
    "has_mangal_dosha": false,
    "mars_house": 11,
    "dosha_type": null,
    "cancellations": []
  },
  "match_verdict": "acceptable",
  "explanation": "Boy has Mangal Dosha but cancellation applies; girl is Manglik-free. Marriage can proceed with classical remedies."
}

Field reference

Every field in the response, with its type, a real example, and what it means.

Field	Type	Meaning
boy.has_mangal_dosha	boolean	Whether Mars is in 1st, 2nd, 4th, 7th, 8th, or 12th house (Mangal positions). example: `true`
boy.mars_house	integer (1–12)	House Mars occupies. example: `8`
boy.dosha_type	string \| null	Severity classification: Low / Moderate / Severe based on house. example: `"Kuja Dosha (Severe)"`
boy.cancellations	string[]	Applicable cancellation rules. Empty if none apply. example: `["Mars in own sign"]`
match_verdict	string	"ok" (neither has dosha), "acceptable" (cancellation), "caution" (both have dosha — cancels each other), "warning" (one has, one doesn't, no cancellation). example: `"acceptable"`
explanation	string	Plain-language summary. example: `"Boy has Mangal Dosha…"`

Usage tips

How to use it

Always compute cancellations
Never show "Mangal Dosha present" without listing applicable cancellations — it creates unnecessary anxiety.
Parameter pattern
Call with boy_* and girl_* birth data, or call twice with a single person's data.

Errors

Every error follows the same envelope. Use the error.code field (not the message) for conditional logic in your integration.

401 Unauthorized

{
  "error": {
    "code": "unauthorized",
    "message": "missing or invalid API key",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

402 Payment Required

{
  "error": {
    "code": "trial_exhausted",
    "message": "your free trial credits are exhausted — pick a plan to continue",
    "top_up_url": "https://divyastroapi.com/pricing",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

429 Too Many Requests

{
  "error": {
    "code": "rate_limited",
    "message": "rate limit exceeded; retry after 12 seconds",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

Try it

Get a dv_live_* key from your dashboard and paste into the cURL snippet above. New accounts get 500 free credits. Sign up.