/v1/milan/dasha-sync

Dasha synchronization score.

What this tells you

Shows which Vimshottari Maha Dasha each partner is running at one moment, and when each one ends. Use it to see whether either partner is close to a Maha Dasha change around the wedding. It does not score lord friendship or look at Antar Dashas.

The check moment is now, unless you pass date (with time and tz, unprefixed), for example date=2027-02-15&time=10:00&tz=Asia/Kolkata. If date is given but the moment cannot be parsed (for example tz is missing), the current time is used without an error.

Request

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

example request

curl "https://api.lifeastroapi.com/v1/milan/dasha-sync?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

{
  "boy_current_md": "Rahu",
  "girl_current_md": "Jupiter",
  "boy_md_end_jd": 2466464.719622,
  "girl_md_end_jd": 2463503.729829,
  "overlap": true,
  "note": "MDs overlap if their windows intersect at the current moment"
}

Field reference

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

Field	Type	Meaning
boy_current_md, girl_current_md	string	Lord of the Vimshottari Maha Dasha each partner is running at the check moment. example: `"Rahu", "Jupiter"`
boy_md_end_jd, girl_md_end_jd	number	End of each running Maha Dasha as a Julian Day (UT). example: `2466464.719622, 2463503.729829`
overlap	boolean	Whether the two running Maha Dasha windows intersect. Both windows contain the check moment, so this is true whenever the moment falls inside both 120-year cycles. example: `true`
note	string	Fixed explanatory text. example: `"MDs overlap if their windows intersect at the current moment"`

Usage tips

How to use it

Check a wedding date
Pass the planned date as date, time and tz to get the Maha Dashas running on that day.
Show time left
Convert boy_md_end_jd and girl_md_end_jd to dates to show how long each running Maha Dasha has left. For all 5 levels, call /v1/dasha/vimshottari/current for each partner.
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.