/v1/milan/nadi-dosha

Nadi dosha with exceptions.

What this tells you

Nadi Dosha occurs when both partners have the same nadi — Aadi, Madhya or Antya — from their Moon nakshatras. The classical concern is health and progeny. Nadi is the highest-weighted koota (8 of 36 points), so a Nadi Dosha can fail an otherwise strong match. The API exempts six specific same-nadi nakshatra pairs and reports them as "classical_rishi_exception". It does not apply rashi- or pada-based exceptions.

Request

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

example request

curl "https://api.lifeastroapi.com/v1/milan/nadi-dosha?boy.date=1990-01-15&boy.tz=Asia%2FKolkata&girl.date=1992-03-20&girl.tz=Asia%2FKolkata&boy.time=10%3A30&girl.time=08%3A15" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query parameters

Checked against the API: a parameter is marked required when the request fails without it.

Name	Required	Example	Description
`boy.date`	yes	`1990-01-15`	Boy's birth date (YYYY-MM-DD).
`boy.tz`	yes	`Asia/Kolkata`	Boy's birth place timezone: IANA name (Asia/Kolkata) or UTC offset (+05:30).
`girl.date`	yes	`1992-03-20`	Girl's birth date (YYYY-MM-DD).
`girl.tz`	yes	`Asia/Kolkata`	Girl's birth place timezone: IANA name (Asia/Kolkata) or UTC offset (+05:30).
`boy.time`	no	`10:30`	Boy's birth time (HH:MM, 24-hour, local). Defaults to 12:00.
`girl.time`	no	`08:15`	Girl's birth time (HH:MM, 24-hour, local). Defaults to 12:00.
`person1.date`	no	—
`person1.tz`	no	—
`person2.date`	no	—
`person2.tz`	no	—
`ayanamsa`	no	—	Ayanamsa (sidereal offset) to use. Defaults to lahiri.

Response (200 OK)

The real response to the example request above, generated from the API itself. Long arrays are trimmed to their first two items. Field names are stable across versions.

200 response

{
  "has_dosha": true,
  "boy_nadi": "Madhya",
  "girl_nadi": "Madhya",
  "severity": "high",
  "exceptions_applied": [],
  "health": {
    "DoshaName": "Pitta Nadi Dosha",
    "HealthRisk": "Pitta (bile) related disorders — digestive issues, blood pressure, liver problems",
    "Element": "Pitta (पित्त)"
  }
}

Field reference

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

Field	Type	Meaning
has_dosha	boolean	True when both partners have the same nadi and their nakshatra pair is not an exception. example: `true`
boy_nadi, girl_nadi	string	Nadi of each partner's Moon nakshatra: Aadi, Madhya or Antya. example: `"Madhya"` Jyotish: Aadi = Vata, Madhya = Pitta, Antya = Kapha.
severity	string	"none" (different nadis), "exempted" (same nadi, but the pair is an exception) or "high" (dosha). example: `"high"`
exceptions_applied	string[]	["classical_rishi_exception"] when the pair is exempt; otherwise empty. example: `[]`
health	object	Ayurvedic context for the shared nadi. Only present when has_dosha is true. Note the PascalCase keys. example: `{ "DoshaName": …, "HealthRisk": …, "Element": … }`
health.DoshaName	string	Name of the dosha for this nadi. example: `"Pitta Nadi Dosha"`
health.HealthRisk	string	Health areas traditionally linked to this nadi. example: `"Pitta (bile) related disorders — digestive issues, blood pressure, liver problems"`
health.Element	string	Ayurvedic dosha of the nadi. example: `"Pitta (पित्त)"`

Usage tips

How to use it

Always list exceptions
Show severity and exceptions_applied. "exempted" means the nadis match but the pair is a listed exception, so has_dosha is false.
health is optional
health is left out when there is no dosha. Its keys are DoshaName, HealthRisk and Element (PascalCase, unlike the rest of the API).
Parameters
Pass boy.date, boy.time, boy.tz and girl.date, girl.time, girl.tz (time defaults to 12:00). Optional: ayanamsa.

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://lifeastroapi.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 1,500 free credits. Sign up.