{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/asterwise-com/json-schema/asterwise-com-api-response-spread-response-schema.json",
  "title": "ApiResponse[SpreadResponse]",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/asterwise-com-tarot-api-openapi.yml#/components/schemas/ApiResponse_SpreadResponse_",
  "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/SpreadResponse",
      "description": "The endpoint response payload"
    }
  },
  "type": "object",
  "required": [
    "data"
  ],
  "$defs": {
    "DrawnCardSchema": {
      "properties": {
        "card": {
          "$ref": "#/$defs/TarotCardSchema"
        },
        "is_reversed": {
          "type": "boolean",
          "title": "Is Reversed",
          "description": "True if the card was drawn in reversed orientation"
        },
        "position": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Position",
          "description": "Spread position name e.g. 'past', 'present', 'outcome'"
        },
        "position_meaning": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Position Meaning",
          "description": "What this spread position represents"
        },
        "active_meaning": {
          "type": "string",
          "title": "Active Meaning",
          "description": "The meaning to apply — upright_meaning when is_reversed=False, reversed_meaning when True"
        },
        "active_keywords": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Active Keywords",
          "description": "Active keywords for this orientation"
        }
      },
      "type": "object",
      "required": [
        "card",
        "is_reversed",
        "active_meaning",
        "active_keywords"
      ],
      "title": "DrawnCardSchema"
    },
    "SpreadResponse": {
      "properties": {
        "spread_type": {
          "type": "string",
          "title": "Spread Type",
          "description": "Spread type: 'three_card' or 'celtic_cross'"
        },
        "positions": {
          "items": {
            "$ref": "#/$defs/DrawnCardSchema"
          },
          "type": "array",
          "title": "Positions"
        },
        "question": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Question",
          "description": "The question posed, if provided"
        }
      },
      "type": "object",
      "required": [
        "spread_type",
        "positions"
      ],
      "title": "SpreadResponse"
    },
    "TarotCardSchema": {
      "properties": {
        "id": {
          "type": "string",
          "title": "Id",
          "description": "Unique slug identifier e.g. 'the-fool'"
        },
        "name": {
          "type": "string",
          "title": "Name",
          "description": "Full card name e.g. 'The Fool'"
        },
        "arcana_type": {
          "type": "string",
          "title": "Arcana Type",
          "description": "'major' or 'minor'"
        },
        "suit": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Suit",
          "description": "Suit for minor arcana: wands, cups, swords, pentacles. Null for major arcana."
        },
        "number": {
          "type": "integer",
          "title": "Number",
          "description": "Card number. Major arcana: 0-21. Minor arcana: 1=Ace, 11=Page, 12=Knight, 13=Queen, 14=King."
        },
        "element": {
          "type": "string",
          "title": "Element",
          "description": "Elemental correspondence: fire, water, air, earth, spirit"
        },
        "astrology_correspondence": {
          "type": "string",
          "title": "Astrology Correspondence",
          "description": "Astrological planet or sign correspondence"
        },
        "keywords_upright": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Keywords Upright",
          "description": "Upright keywords"
        },
        "keywords_reversed": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Keywords Reversed",
          "description": "Reversed keywords"
        },
        "upright_meaning": {
          "type": "string",
          "title": "Upright Meaning",
          "description": "Full upright interpretation"
        },
        "reversed_meaning": {
          "type": "string",
          "title": "Reversed Meaning",
          "description": "Full reversed interpretation"
        },
        "yes_no": {
          "type": "string",
          "title": "Yes No",
          "description": "Yes/No polarity: 'yes', 'no', or 'maybe'"
        },
        "description": {
          "type": "string",
          "title": "Description",
          "description": "Visual description of the card imagery"
        }
      },
      "type": "object",
      "required": [
        "id",
        "name",
        "arcana_type",
        "number",
        "element",
        "astrology_correspondence",
        "keywords_upright",
        "keywords_reversed",
        "upright_meaning",
        "reversed_meaning",
        "yes_no",
        "description"
      ],
      "title": "TarotCardSchema"
    }
  }
}