/v1/milan/shani-dosha

Shani (Saturn) dosha check.

What this tells you

A timing-based dosha specific to the marriage decision: whether either partner is undergoing Sade Sati (Saturn's 7.5-year transit over natal Moon) at the proposed wedding date. Not a reason to reject the match — a reason to reconsider the muhurta.

Request

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

example request

curl "https://api.divyastroapi.com/v1/milan/shani-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_sade_sati": false,
  "girl_has_sade_sati": true,
  "girl_sade_sati_phase": "peak",
  "has_shani_dosha": true,
  "explanation": "Girl is in peak Sade Sati (Saturn transit over natal Moon). Consider postponing marriage until first phase ends."
}

Field reference

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

Field	Type	Meaning
boy_has_sade_sati, girl_has_sade_sati	boolean	Whether each partner is currently in Sade Sati. example: `true`
*_sade_sati_phase	string \| null	pre / peak / post phase. Null if not in Sade Sati. example: `"peak"`
has_shani_dosha	boolean	Whether the current Shani influence is significant for marriage timing. example: `true`
explanation	string	Recommendation text. example: `…`

Usage tips

How to use it

Combine with muhurta picker
If Shani Dosha is active, pipe into /v1/muhurta/best-time to find dates after the Sade Sati phase ends.

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.