GET/v1/crystals

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

Request parameters

No fields documented in the OpenAPI schema.

Response fields

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

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

API key tier does not include this endpoint.

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

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

Request

GET·application/json

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

Response

200 OK·application/jsonsigned

{
  "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"
    ]
  }
}