{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/asterwise-com/json-schema/asterwise-com-api-response-crystal-recommend-response-schema.json",
  "title": "ApiResponse[CrystalRecommendResponse]",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/asterwise-com-crystals-api-openapi.yml#/components/schemas/ApiResponse_CrystalRecommendResponse_",
  "properties": {
    "success": {
      "type": "boolean",
      "title": "Success",
      "description": "True if the request succeeded",
      "default": true
    },
    "message": {
      "type": "string",
      "title": "Message",
      "description": "Human-readable status message",
      "default": "success"
    },
    "data": {
      "$ref": "#/$defs/CrystalRecommendResponse",
      "description": "The endpoint response payload"
    }
  },
  "type": "object",
  "required": [
    "data"
  ],
  "$defs": {
    "CrystalEntry": {
      "properties": {
        "slug": {
          "type": "string",
          "title": "Slug",
          "description": "URL-safe identifier, e.g. 'amethyst', 'blue-sapphire'."
        },
        "name": {
          "type": "string",
          "title": "Name",
          "description": "Display name of the crystal."
        },
        "colors": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Colors",
          "description": "Primary colours of this crystal."
        },
        "hardness_mohs": {
          "type": "number",
          "title": "Hardness Mohs",
          "description": "Hardness on the Mohs scale (1-10)."
        },
        "chakras": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Chakras",
          "description": "Associated chakras."
        },
        "element": {
          "type": "string",
          "title": "Element",
          "description": "Classical element: Earth, Water, Fire, Air, or All."
        },
        "zodiac_signs": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Zodiac Signs",
          "description": "Associated Western zodiac signs."
        },
        "vedic_planet": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Vedic Planet",
          "description": "Vedic planet: the planet of a navaratna gem, or the planet an uparatna substitutes for. Null if the stone has no Vedic gem use."
        },
        "vedic_correspondence": {
          "type": "string",
          "title": "Vedic Correspondence",
          "description": "'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)."
        },
        "western_planet": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Western Planet",
          "description": "Western metaphysical planetary correspondence."
        },
        "keywords": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Keywords",
          "description": "Primary energy keywords."
        },
        "healing_physical": {
          "type": "string",
          "title": "Healing Physical",
          "description": "Physical healing properties."
        },
        "healing_emotional": {
          "type": "string",
          "title": "Healing Emotional",
          "description": "Emotional healing properties."
        },
        "healing_spiritual": {
          "type": "string",
          "title": "Healing Spiritual",
          "description": "Spiritual healing properties."
        },
        "description": {
          "type": "string",
          "title": "Description",
          "description": "Overview description."
        },
        "origins": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Origins",
          "description": "Primary geographic origins."
        },
        "affirmation": {
          "type": "string",
          "title": "Affirmation",
          "description": "Affirmation for working with this crystal."
        },
        "caution": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Caution",
          "description": "Important safety or usage cautions. Null if none."
        }
      },
      "type": "object",
      "required": [
        "slug",
        "name",
        "colors",
        "hardness_mohs",
        "chakras",
        "element",
        "zodiac_signs",
        "vedic_correspondence",
        "keywords",
        "healing_physical",
        "healing_emotional",
        "healing_spiritual",
        "description",
        "origins",
        "affirmation"
      ],
      "title": "CrystalEntry"
    },
    "CrystalRecommendResponse": {
      "properties": {
        "total": {
          "type": "integer",
          "title": "Total",
          "description": "Number of crystals returned."
        },
        "filters_applied": {
          "additionalProperties": true,
          "type": "object",
          "title": "Filters Applied",
          "description": "The filters used for this recommendation."
        },
        "crystals": {
          "items": {
            "$ref": "#/$defs/CrystalEntry"
          },
          "type": "array",
          "title": "Crystals",
          "description": "Recommended crystals sorted by match strength."
        }
      },
      "type": "object",
      "required": [
        "total",
        "filters_applied",
        "crystals"
      ],
      "title": "CrystalRecommendResponse"
    }
  }
}