/v1/chart/planet/{name}

Single planet detail.

What this tells you

Same as /v1/chart/planets but scoped to a single planet. Useful when your UI only needs one planet (e.g. "which house is my Moon in?") — saves response size and is easier to call on demand.

Request

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

example request

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

{
  "name": "Moon", "abbr": "Mo",
  "longitude": 53.772, "sign": "Taurus", "sign_index": 2, "degree_in_sign": 23.772,
  "nakshatra": "Mrigashira", "nakshatra_index": 5, "pada": 1, "nakshatra_lord": "Mars",
  "house": 11, "retrograde": false, "combust": false,
  "speed_deg_per_day": 13.428,
  "dignity": { "status": "neutral", "is_exalted": false, "is_debilitated": false, "is_own_sign": false, "is_moolatrikona": false }
}

Field reference

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

Field	Type	Meaning
name	string	Planet name (matches the request path variable). example: `"Moon"`
longitude	number	Sidereal longitude. example: `53.772`
sign, sign_index, degree_in_sign	…	Sign placement details. Same as /v1/chart/planets. example: `…`
nakshatra, pada, nakshatra_lord	…	Nakshatra placement. example: `…`
house	integer	Whole-sign house from the birth ascendant. example: `11`
dignity.status	string	"exalted", "debilitated", "own_sign", "moolatrikona", "friend", "neutral", "enemy". example: `"neutral"`

Usage tips

How to use it

Path accepts these names
sun, moon, mars, mercury, jupiter, venus, saturn, rahu, ketu (case-insensitive).

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.