---
title: "Complete crystal database"
method: GET
path: "/v1/crystals"
tags: ["Crystals"]
---

# Complete crystal database

`GET /v1/crystals`

## Request

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

Returns all 54 crystals in the database sorted alphabetically. Each entry includes chakra associations, elemental correspondences, Vedic and Western planetary assignments, healing properties, origins, affirmations, and safety cautions. Vedic correspondences are strictly separated: 'navaratna' (classical primary gem), 'uparatna' (substitute gem; the description says when a substitute is modern rather than classical), or 'none_classical' (no Vedic gem use).

## Response `200`

Successful Response

- ApiResponseCrystalListResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` CrystalListResponse, required
    - `total` integer, required: Total number of crystals in the database.
    - `crystals` CrystalEntry[], required: All crystals sorted alphabetically.
      - `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)