---
title: "Crystals by Planet"
method: GET
path: "/esoteric/crystals/by-planet/{planet}"
tags: ["Esoteric"]
---

# Crystals by Planet

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

## Request

- Base URL: `https://api.astroway.info/v1`
- URL: `https://api.astroway.info/v1/esoteric/crystals/by-planet/{planet}`
- Auth: API key in header `X-Api-Key`
- TypeScript: <https://skmtc.dev/astroway/apis/astroway-calculation-api/docs/esoteric/crystals/by-planet/:planet/get.ts> (a function with typed inputs; its response is checked against the schema)

Crystals whose traditional planetary correspondence is the given planet (sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, earth).

## Path parameters

- `planet` 'sun' | 'moon' | 'mercury' | 'venus' | 'mars' | 'jupiter' | 'saturn' | 'uranus' | 'neptune' | 'pluto' | 'earth', required

## Query parameters

- `fields` string
- `precision` integer

## Response `200`

Successful calculation

- object
  - `ok` boolean
  - `data` object
    - `planet` string, nullable
    - `items` object[], nullable
      - `name` string, nullable
      - `color` string, nullable
      - `chakra` string[], nullable
      - `zodiacSigns` string[], nullable
      - `planet` string[], nullable
      - `element` string, nullable
      - `hardness` number, nullable
      - `purposes` string[], nullable
      - `description` string, nullable
    - `count` number, nullable

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key

## Changes

- **2026-11-07** `bf266b2e6703`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/astroway/apis/astroway-calculation-api/changes/esoteric/crystals/by-planet/:planet/get.md)

---

[API](https://skmtc.dev/astroway/apis/astroway-calculation-api.md) - [All operations](https://skmtc.dev/astroway/apis/astroway-calculation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/astroway/apis/astroway-calculation-api/revisions/bf266b2e6703?raw)