---
title: "Rudraksha Recommendations"
method: GET
path: "/v1/astro/rudraksha"
tags: ["Astrology"]
---

# Rudraksha Recommendations

`GET /v1/astro/rudraksha`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/astro/rudraksha`
- Auth: HTTP bearer

Returns Rudraksha bead recommendations per planet. Each planet maps to a specific mukhi (face count) with presiding deity, exact beej mantra, recommended metal, wearing day, how the bead is worn (strung at the neck or wrist, not on a finger), and classical notes including the important distinction that mukhi assignments are attributed to deities in tradition — planetary correspondence is traditional astrological synthesis. Pass ?planet=Jupiter for a single planet. Omit ?planet to get all nine planets.

## Query parameters

- `planet` string, nullable: One of Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu (case-sensitive). Omit for all nine.

## Response `200`

Successful Response

- ApiResponseUnionRudrakshaAllResponseRudrakshaSingleResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` union, required: The endpoint response payload
    - RudrakshaAllResponse
      - `planets` object, required
    - RudrakshaSingleResponse
      - `mukhi` integer, required
      - `presiding_deity` string, required
      - `mantra` string, required
      - `metal` string, required
      - `wearing_day` string, required
      - `mala_beads` integer, required
      - `wearing_finger` string, required: Legacy field, kept for compatibility. Rudraksha is not worn on a finger, so this is always 'Not applicable (worn on neck or wrist)'. See how_to_wear.
      - `how_to_wear` string, required: How the bead is worn: strung on thread or capped in the listed metal, at the neck (pendant or mala) or on the wrist (Shiva Purana Vidyeshvara Samhita Ch.25).
      - `benefits` string, required
      - `planet` string, required

## Other responses

- `401`: Authentication failed
- `403`: Authorization failed
- `404`: Resource not found
- `413`: Payload too large
- `422`: Validation error
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream provider error
- `503`: Service unavailable

---

[API](https://skmtc.dev/asterwise/apis/asterwise-api.md) · [All operations](https://skmtc.dev/asterwise/apis/asterwise-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asterwise/apis/asterwise-api/revisions/3c4bbb1194e2?raw)