/v1/transit/tarabala

Tarabala score for a transit.

What this tells you

Tarabala ("star strength") measures the relationship between a transiting nakshatra and the natal Janma Nakshatra. Used for day-to-day muhurta: "is today's Moon nakshatra favorable for me?" Also a factor in vivah muhurta scoring.

Request

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

example request

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

{
  "natal_nakshatra": "Mrigashira",
  "current_nakshatra": "Pushya",
  "nakshatra_count": 5,
  "tara_index": 5,
  "tara_name": "Pratyak Tara",
  "is_favorable": false,
  "remedy_suggestion": "Chant 'Om Shanaishcharaaya Namah' 108 times"
}

Field reference

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

Field	Type	Meaning
natal_nakshatra	string	The native's Janma Nakshatra. example: `"Mrigashira"`
current_nakshatra	string	Current Moon's nakshatra (or nakshatra being transited). example: `"Pushya"`
nakshatra_count	integer (1–9)	Count from natal nakshatra (modulo 9). example: `5`
tara_index	integer (1–9)	Tara category. example: `5`
tara_name	string	1 Janma, 2 Sampad, 3 Vipad, 4 Kshem, 5 Pratyak, 6 Sadhak, 7 Vadh, 8 Mitra, 9 Atimitra. example: `"Pratyak Tara"`
is_favorable	boolean	Sampad (2), Kshem (4), Sadhak (6), Mitra (8), Atimitra (9) are favorable. Janma (1), Vipad (3), Pratyak (5), Vadh (7) are unfavorable. example: `false`
remedy_suggestion	string	Classical remedy if unfavorable. example: `…`

Usage tips

How to use it

Daily widget
Fetch once per day per user. If unfavorable, show the remedy as a soft suggestion.

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.