/v1/dasha/vimshottari/current

Current MD/AD/PD/SD/PPD period.

What this tells you

Returns the active period at every level, at any requested moment. Much more compact than the full Vimshottari schedule — use this for "you are here" displays and daily horoscope widgets.

Request

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

example request

curl "https://api.divyastroapi.com/v1/dasha/vimshottari/current?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

{
  "at_moment": "2026-04-19T14:30:00+05:30",
  "maha_dasha": {
    "lord": "Jupiter",
    "start_date": "2014-09-03",
    "end_date":   "2030-09-03",
    "elapsed_pct": 72.4,
    "remaining_years": 4.4
  },
  "antar_dasha": {
    "lord": "Mercury",
    "start_date": "2024-11-14",
    "end_date":   "2027-02-23",
    "elapsed_pct": 61.2,
    "remaining_months": 10.1
  },
  "pratyantar_dasha": {
    "lord": "Mars",
    "start_date": "2026-02-08",
    "end_date":   "2026-06-20",
    "elapsed_pct": 55.9,
    "remaining_days": 62
  },
  "sookshma_dasha": {
    "lord": "Rahu",
    "start_date": "2026-04-12",
    "end_date":   "2026-04-29",
    "elapsed_pct": 42.3,
    "remaining_hours": 235.8
  },
  "praana_dasha": {
    "lord": "Jupiter",
    "start_date": "2026-04-19T08:14:00",
    "end_date":   "2026-04-19T18:42:00",
    "elapsed_pct": 59.8,
    "remaining_minutes": 252
  }
}

Interactive preview

click any node to expand

Levels: Mahadasha → Antardasha → Pratyantar → Sookshma → Praana. Sample data.

Field reference

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

Field	Type	Meaning
at_moment	string (ISO)	The reference moment. If you pass no date/time params, defaults to "now". example: `"2026-04-19T14:30:00+05:30"`
maha_dasha	object	Active Mahadasha at this moment. example: `…`
antar_dasha, pratyantar_dasha, sookshma_dasha, praana_dasha	object	Active periods at the 2nd, 3rd, 4th, and 5th levels. example: `…`
*.lord	string	Ruling planet for that period. example: `"Jupiter"`
*.start_date, end_date	string	Period boundaries. example: `…`
*.elapsed_pct	number (0–100)	Percentage of the period completed. Useful for progress bars. example: `72.4`
.remaining_	number	Remaining time in appropriate unit — years/months/days/hours/minutes. example: `4.4`

Usage tips

How to use it

Daily widget
This is the go-to endpoint for "what's my current dasha?" widgets. 1 credit, O(1) response time.
No cache beyond 24h
Periods change — cache at most for a day. Preferably recompute every refresh.

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.