Complete crystal database

Returns all 50 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' (classical substitute), or 'none_classical' (no Vedic text assigns this stone).

Endpoint

GET /v1/crystals

Request parameters

No fields documented in the OpenAPI schema.

Example request

curl

curl -X GET "https://api.asterwise.com/v1/crystals" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import asterwise
from asterwise.api.crystals_api import CrystalsApi

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

with asterwise.ApiClient(configuration) as client:
    api = CrystalsApi(client)
    result = api.crystals_list()
    print(result)

TypeScript

import { createClient, createConfig, crystalsList } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await crystalsList({
  client,
});

console.log(result.data);

Example response

{
  "success": true,
  "message": "success",
  "data": {
    "total": 50,
    "crystals": [
      {
        "slug": "amazonite",
        "name": "Amazonite",
        "colors": [
          "blue-green",
          "turquoise-green"
        ],
        "hardness_mohs": 6.5,
        "chakras": [
          "Heart",
          "Throat"
        ],
        "element": "Earth",
        "zodiac_signs": [
          "Virgo",
          "Aquarius"
        ],
        "vedic_planet": null,
        "vedic_correspondence": "none_classical",
        "western_planet": "Uranus",
        "keywords": [
          "authentic expression",
          "harmony",
          "... and 3 more items"
        ],
        "healing_physical": "Harmonises the nervous system and supports musculoskeletal health.",
        "healing_emotional": "Bridges the heart and throat for authentic self-expression free from judgment.",
        "healing_spiritual": "Balances masculine and feminine energies. No classical Vedic planetary assignment.",
        "description": "Green feldspar named after the Amazon River. Bridges Heart and Throat chakras for harmonious authentic expression.",
        "origins": [
          "Brazil",
          "Russia",
          "... and 2 more items"
        ],
        "affirmation": "I speak my truth with a heart full of compassion.",
        "caution": null
      },
      {
        "slug": "amethyst",
        "name": "Amethyst",
        "colors": [
          "purple",
          "violet"
        ],
        "hardness_mohs": 7.0,
        "chakras": [
          "Third Eye",
          "Crown"
        ],
        "element": "Air",
        "zodiac_signs": [
          "Aquarius",
          "Pisces"
        ],
        "vedic_planet": "Saturn",
        "vedic_correspondence": "uparatna",
        "western_planet": "Jupiter",
        "keywords": [
          "protection",
          "intuition",
          "... and 3 more items"
        ],
        "healing_physical": "Supports nervous system, headaches, insomnia, and hormonal balance.",
        "healing_emotional": "Calms anxiety, reduces anger, promotes emotional centering.",
        "healing_spiritual": "Opens Third Eye, enhances intuition, supports meditation and psychic protection.",
        "description": "A violet variety of quartz revered across cultures for spiritual protection and mental clarity. Its purple hue ranges fr…",
        "origins": [
          "Brazil",
          "Uruguay",
          "... and 2 more items"
        ],
        "affirmation": "I trust my intuition and am protected by divine light.",
        "caution": "In Jyotish, deep purple Amethyst invokes Saturn's karmic energy. Consult a practitioner before wearing for astrological…"
      },
      "... and 48 more items"
    ]
  }
}

Response fields

Field	Type	Description
success	boolean	True if the request succeeded
message	string	Human-readable status message
data	object
data.total	integer	Total number of crystals in the database.
data.crystals	array[object]	All crystals sorted alphabetically.
data.crystals[].slug	string	URL-safe identifier, e.g. 'amethyst', 'blue-sapphire'.
data.crystals[].name	string	Display name of the crystal.
data.crystals[].colors	array[string]	Primary colours of this crystal.
data.crystals[].hardness_mohs	number	Hardness on the Mohs scale (1-10).
data.crystals[].chakras	array[string]	Associated chakras.
data.crystals[].element	string	Classical element: Earth, Water, Fire, Air, or All.
data.crystals[].zodiac_signs	array[string]	Associated Western zodiac signs.
data.crystals[].vedic_planet	string | null	Vedic planetary correspondence. Null if no classical Vedic text assigns this stone.
data.crystals[].vedic_correspondence	string	'navaratna' (primary classical gem), 'uparatna' (substitute gem), or 'none_classical' (no Vedic text assigns this stone).
data.crystals[].western_planet	string | null	Western metaphysical planetary correspondence.
data.crystals[].keywords	array[string]	Primary energy keywords.
data.crystals[].healing_physical	string	Physical healing properties.
data.crystals[].healing_emotional	string	Emotional healing properties.
data.crystals[].healing_spiritual	string	Spiritual healing properties.
data.crystals[].description	string	Overview description.
data.crystals[].origins	array[string]	Primary geographic origins.
data.crystals[].affirmation	string	Affirmation for working with this crystal.
data.crystals[].caution	string | null	Important safety or usage cautions. Null if none.

Errors

Code	Description	Reference
authentication_failed	Missing or invalid API key.	authentication_failed
ephemeris_unavailable	Upstream ephemeris service error.	ephemeris_unavailable
insufficient_tier	API key tier does not include this endpoint.	insufficient_tier
internal_error	Unexpected server error.	internal_error
ip_rate_limit_exceeded	Too many requests in a short window.	ip_rate_limit_exceeded
payload_too_large	Request body exceeds the size limit.	payload_too_large
resource_not_found	Referenced resource was not found.	resource_not_found
validation_error	Request body failed schema validation.	validation_error

Related endpoints

• Single crystal lookup
• Crystal recommendations
• Crystals by Vedic planet
• Crystal recommendations from Vedic natal chart