GET/v1/crystals

Complete crystal database

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

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 planet: the planet of a navaratna gem, or the planet an uparatna substitutes for. Null if the stone has no Vedic gem use.

data.crystals[].vedic_correspondence

string

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

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

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

• Single crystal lookup
• Crystal recommendations
• Crystals by Vedic planet
• Natal Chart Crystal Recommendations

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": 54,
    "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 52 more items"
    ]
  }
}