/v1/chart/nakshatra

Moon nakshatra + pada.

What this tells you

This is a convenience endpoint that returns everything about a native's Janma Nakshatra (Moon's nakshatra at birth) including all the attributes needed for Ashtakoota matchmaking. Faster than computing each individually.

Request

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

example request

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

{
  "moon_nakshatra": {
    "name": "Mrigashira", "index": 5,
    "pada": 1,
    "lord": "Mars",
    "deity": "Soma",
    "symbol": "Deer's head",
    "gana": "Deva",
    "yoni": "Snake (female)",
    "nadi": "Aadi (first)",
    "varna": "Brahmin",
    "vashya": "Chatushpada"
  }
}

Field reference

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

Field	Type	Meaning
moon_nakshatra.name	string	Janma Nakshatra — the Moon's nakshatra at birth. Single most important nakshatra for the native. example: `"Mrigashira"`
moon_nakshatra.pada	integer	Quarter within the nakshatra. Drives Navamsa. example: `1`
moon_nakshatra.lord	string	Nakshatra lord — drives Vimshottari dasha start. example: `"Mars"`
moon_nakshatra.gana	string	Temperament. Used in Ashtakoota Gana Koota. example: `"Deva"`
moon_nakshatra.yoni	string	Yoni (animal nature). Used in Ashtakoota Yoni Koota. example: `"Snake (female)"`
moon_nakshatra.nadi	string	Aadi / Madhya / Antya. Used in Ashtakoota Nadi Koota — the most important koota. example: `"Aadi (first)"`
moon_nakshatra.varna	string	Used in Ashtakoota Varna Koota. example: `"Brahmin"`
moon_nakshatra.vashya	string	Used in Ashtakoota Vashya Koota. example: `"Chatushpada"`

Usage tips

How to use it

Great for compatibility apps
Call this for each partner once; the output feeds directly into Ashtakoota scoring.
Cache forever
Birth-fixed. Hash birth details and cache indefinitely.

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.