---
title: "Crystals by Vedic planet"
method: GET
path: "/v1/crystals/by-planet/{planet}"
tags: ["Crystals"]
---

# Crystals by Vedic planet

`GET /v1/crystals/by-planet/{planet}`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/crystals/by-planet/{planet}`
- Auth: HTTP bearer

Returns all crystals associated with a specific Vedic planet. Planets: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu. Results are sorted with primary Navaratna gems first, then Uparatna substitutes, each group alphabetically. Only Navaratna and Uparatna Vedic assignments are included — crystals without classical Vedic gemstone support are not returned here.

## Path parameters

- `planet` string, required

## Response `200`

Successful Response

- ApiResponseCrystalsByPlanetResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` CrystalsByPlanetResponse, required: GET /v1/crystals/by-planet/{planet}: one planet's gems, not the catalogue.
    - `total` integer, required: Number of crystals assigned to the planet (the length of crystals).
    - `crystals` CrystalEntry[], required: Crystals whose Vedic planet is the requested planet: Navaratna (primary gem) first, then Uparatna (substitutes), each group sorted alphabetically by name.
      - `slug` string, required: URL-safe identifier, e.g. 'amethyst', 'blue-sapphire'.
      - `name` string, required: Display name of the crystal.
      - `colors` string[], required: Primary colours of this crystal.
      - `hardness_mohs` number, required: Hardness on the Mohs scale (1-10).
      - `chakras` string[], required: Associated chakras.
      - `element` string, required: Classical element: Earth, Water, Fire, Air, or All.
      - `zodiac_signs` string[], required: Associated Western zodiac signs.
      - `vedic_planet` string, nullable: Vedic planet: the planet of a navaratna gem, or the planet an uparatna substitutes for. Null if the stone has no Vedic gem use.
      - `vedic_correspondence` string, required: 'navaratna' (primary classical gem, Phaladeepika table), 'uparatna' (substitute gem — includes common modern substitutes such as Tiger's Eye for Ketu; the description says when a substitute is not classical), or 'none_classical' (no Vedic gem use).
      - `western_planet` string, nullable: Western metaphysical planetary correspondence.
      - `keywords` string[], required: Primary energy keywords.
      - `healing_physical` string, required: Physical healing properties.
      - `healing_emotional` string, required: Emotional healing properties.
      - `healing_spiritual` string, required: Spiritual healing properties.
      - `description` string, required: Overview description.
      - `origins` string[], required: Primary geographic origins.
      - `affirmation` string, required: Affirmation for working with this crystal.
      - `caution` string, nullable: Important safety or usage cautions. Null if none.

## 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)