{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/asterwise-com/json-schema/asterwise-com-api-response-horoscope-data-schema.json",
  "title": "ApiResponse[HoroscopeData]",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/asterwise-com-horoscope-api-openapi.yml#/components/schemas/ApiResponse_HoroscopeData_",
  "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/HoroscopeData",
      "description": "The endpoint response payload"
    }
  },
  "type": "object",
  "required": [
    "data"
  ],
  "$defs": {
    "HoroscopeChapter": {
      "properties": {
        "chapter_number": {
          "type": "integer",
          "title": "Chapter Number"
        },
        "start_date": {
          "type": "string",
          "title": "Start Date",
          "description": "Chapter start date (YYYY-MM-DD)"
        },
        "end_date": {
          "type": "string",
          "title": "End Date",
          "description": "Chapter end date (YYYY-MM-DD)"
        },
        "title": {
          "type": "string",
          "title": "Title"
        },
        "theme": {
          "type": "string",
          "title": "Theme"
        },
        "narrative": {
          "type": "string",
          "title": "Narrative"
        }
      },
      "type": "object",
      "required": [
        "chapter_number",
        "start_date",
        "end_date",
        "title",
        "theme",
        "narrative"
      ],
      "title": "HoroscopeChapter"
    },
    "HoroscopeContent": {
      "properties": {
        "headline": {
          "type": "string",
          "title": "Headline"
        },
        "narrative": {
          "type": "string",
          "title": "Narrative"
        },
        "career": {
          "type": "string",
          "title": "Career"
        },
        "money": {
          "type": "string",
          "title": "Money"
        },
        "love": {
          "type": "string",
          "title": "Love"
        },
        "body": {
          "type": "string",
          "title": "Body"
        },
        "remedy": {
          "type": "string",
          "title": "Remedy",
          "description": "Programmatically injected Vedic remedy text",
          "default": ""
        },
        "do": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Do",
          "description": "Daily: actions to take"
        },
        "avoid": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Avoid",
          "description": "Daily: actions to avoid"
        },
        "open_loop": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Open Loop",
          "description": "Daily: forward-looking watch item"
        },
        "peak_day": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Peak Day",
          "description": "Weekly: strongest day"
        },
        "caution_day": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Caution Day",
          "description": "Weekly: day to approach carefully"
        },
        "weekly_mantra": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Weekly Mantra",
          "description": "Weekly: shareable mantra line"
        },
        "phases": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/HoroscopePhase"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Phases",
          "description": "Monthly: phased breakdown"
        },
        "power_window": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Power Window",
          "description": "Monthly: favorable date window"
        },
        "caution_window": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Caution Window",
          "description": "Monthly: cautious date window"
        },
        "closing_message": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Closing Message",
          "description": "Monthly or yearly: shareable closing line"
        },
        "year_theme": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Year Theme",
          "description": "Yearly: karmic theme for the year"
        },
        "chapters": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/HoroscopeChapter"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Chapters",
          "description": "Yearly: chapter breakdown"
        },
        "auspicious_months": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Auspicious Months",
          "description": "Yearly: top auspicious months by name"
        },
        "landmark_dates": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/HoroscopeLandmarkDate"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Landmark Dates",
          "description": "Yearly: key dates with tone"
        }
      },
      "type": "object",
      "required": [
        "headline",
        "narrative",
        "career",
        "money",
        "love",
        "body"
      ],
      "title": "HoroscopeContent",
      "description": "Stored horoscope prose; fields present depend on horizon (daily/weekly/monthly/yearly)."
    },
    "HoroscopeData": {
      "properties": {
        "content": {
          "$ref": "#/$defs/HoroscopeContent"
        },
        "generated_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Generated At",
          "description": "ISO timestamp when the horoscope was generated (UTC)"
        },
        "period_key": {
          "type": "string",
          "title": "Period Key",
          "description": "The period this horoscope covers, on the India Standard Time calendar: YYYY-MM-DD (daily), YYYY-Www, the ISO week of that week's Monday (weekly), YYYY-MM (monthly) or YYYY (yearly)."
        },
        "horizon": {
          "type": "string",
          "title": "Horizon",
          "description": "Horizon: daily, weekly, monthly, or yearly"
        },
        "moon_sign": {
          "type": "string",
          "title": "Moon Sign",
          "description": "Normalised English Moon sign slug"
        }
      },
      "type": "object",
      "required": [
        "content",
        "period_key",
        "horizon",
        "moon_sign"
      ],
      "title": "HoroscopeData",
      "description": "Payload returned by Vedic horoscope GET endpoints."
    },
    "HoroscopeLandmarkDate": {
      "properties": {
        "date": {
          "type": "string",
          "title": "Date",
          "description": "Landmark date (YYYY-MM-DD)"
        },
        "event": {
          "type": "string",
          "title": "Event"
        },
        "tone": {
          "type": "string",
          "title": "Tone",
          "description": "Either favorable or challenging"
        }
      },
      "type": "object",
      "required": [
        "date",
        "event",
        "tone"
      ],
      "title": "HoroscopeLandmarkDate"
    },
    "HoroscopePhase": {
      "properties": {
        "phase_number": {
          "type": "integer",
          "title": "Phase Number"
        },
        "start_date": {
          "type": "string",
          "title": "Start Date",
          "description": "Phase start date (YYYY-MM-DD)"
        },
        "end_date": {
          "type": "string",
          "title": "End Date",
          "description": "Phase end date (YYYY-MM-DD)"
        },
        "title": {
          "type": "string",
          "title": "Title"
        },
        "narrative": {
          "type": "string",
          "title": "Narrative"
        }
      },
      "type": "object",
      "required": [
        "phase_number",
        "start_date",
        "end_date",
        "title",
        "narrative"
      ],
      "title": "HoroscopePhase"
    }
  }
}