/v1/panchang/yoga

Yoga with transition JD.

What this tells you

Yoga measures the combined angular motion of Sun and Moon — every 13°20' sum = one yoga. There are 27 yogas, classified as auspicious or inauspicious. Yogas are used in muhurta selection — an important activity scheduled during an inauspicious yoga (Vyatipata, Vaidhriti) is traditionally avoided.

Request

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

example request

curl "https://api.divyastroapi.com/v1/panchang/yoga?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

{
  "yoga": {
    "index": 12,
    "name": "Dhruva",
    "type": "auspicious"
  },
  "start_jd": 2461137.318,
  "end_jd":   2461138.202,
  "duration_hours": 21.2,
  "percent_complete": 41.0,
  "ends_at": "2026-04-20T12:18:43+05:30"
}

Field reference

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

Field	Type	Meaning
yoga.index	integer (1–27)	Sequential yoga number. example: `12`
yoga.name	string	Sanskrit name of the yoga. example: `"Dhruva"` Jyotish: The 27 yogas: Vishkambha, Priti, Ayushman, Saubhagya, Shobhana, Atiganda, Sukarma, Dhriti, Shula, Ganda, Vriddhi, Dhruva, Vyaghata, Harshana, Vajra, Siddhi, Vyatipata, Variyana, Parigha, Shiva, Siddha, Sadhya, Shubha, Shukla, Brahma, Indra, Vaidhriti.
yoga.type	string	"auspicious" or "inauspicious" — classification from classical texts. example: `"auspicious"` Jyotish: Inauspicious yogas: Vishkambha, Atiganda, Shula, Ganda, Vyaghata, Vajra, Vyatipata, Parigha, Vaidhriti. The rest are auspicious or neutral.
start_jd	number	When this yoga began. example: `2461137.318`
end_jd	number	When it ends. example: `2461138.202`
duration_hours	number	Yoga durations are ~19–26 hours. example: `21.2`
percent_complete	number	Progress through the yoga. example: `41.0`

Usage tips

How to use it

Combine with tithi for muhurta
A muhurta is never picked from tithi alone — the yoga must also be auspicious. Use this endpoint together with /v1/panchang/tithi.
Nine "mahā dosha" yogas
Nine yogas are classically considered major doshas. Show a warning badge in your UI when any of them is active.

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.