---
title: "Crystals by Zodiac Sign"
method: GET
path: "/esoteric/crystals/by-zodiac/{sign}"
tags: ["Esoteric"]
---

# Crystals by Zodiac Sign

`GET /esoteric/crystals/by-zodiac/{sign}`

## Request

- Base URL: `https://api.astroway.info/v1`
- URL: `https://api.astroway.info/v1/esoteric/crystals/by-zodiac/{sign}`
- Auth: API key in header `X-Api-Key`

Crystals indexed for a given zodiac sign (case-insensitive English name).

## Path parameters

- `sign` string, required

## Query parameters

- `fields` string
- `precision` integer

## Response `200`

Successful calculation

- object
  - `ok` boolean
  - `data` object
    - `sign` 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-09-21** `b64222844186`: 2 info
  - added the new optional `query` request parameter `fields`
  - added the new optional `query` request parameter `precision`
- **2026-08-24** `8ab5a768b521`: 6 info
  - added the optional property `data/items/items/chakra` to the response with the `200` status
  - added the optional property `data/items/items/description` to the response with the `200` status
  - added the optional property `data/items/items/element` to the response with the `200` status
  - added the optional property `data/items/items/hardness` to the response with the `200` status
  - …2 more

[Operation history](https://skmtc.dev/astroway/apis/astroway-calculation-api/changes/esoteric/crystals/by-zodiac/:sign/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/593d763ba9a5?raw)
