---
title: "Weekly horoscope"
method: GET
path: "/v1/horoscope/weekly/{moon_sign}"
tags: ["Horoscope"]
---

# Weekly horoscope

`GET /v1/horoscope/weekly/{moon_sign}`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/horoscope/weekly/{moon_sign}`
- Auth: HTTP bearer

Returns this week's pre-generated weekly horoscope for the given Moon sign.

## Path parameters

- `moon_sign` string, required

## Response `200`

Successful Response

- ApiResponseHoroscopeData
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` HoroscopeData, required: Payload returned by Vedic horoscope GET endpoints.
    - `content` HoroscopeContent, required: Stored horoscope prose; fields present depend on horizon (daily/weekly/monthly/yearly).
      - `headline` string, required
      - `narrative` string, required
      - `career` string, required
      - `money` string, required
      - `love` string, required
      - `body` string, required
      - `remedy` string: Programmatically injected Vedic remedy text
      - `do` string[], nullable: Daily: actions to take
      - `avoid` string[], nullable: Daily: actions to avoid
      - `open_loop` string, nullable: Daily: forward-looking watch item
      - `peak_day` string, nullable: Weekly: strongest day
      - `caution_day` string, nullable: Weekly: day to approach carefully
      - `weekly_mantra` string, nullable: Weekly: shareable mantra line
      - `phases` HoroscopePhase[], nullable: Monthly: phased breakdown
        - `phase_number` integer, required
        - `start_date` string, required: Phase start date (YYYY-MM-DD)
        - `end_date` string, required: Phase end date (YYYY-MM-DD)
        - `title` string, required
        - `narrative` string, required
      - `power_window` string, nullable: Monthly: favorable date window
      - `caution_window` string, nullable: Monthly: cautious date window
      - `closing_message` string, nullable: Monthly or yearly: shareable closing line
      - `year_theme` string, nullable: Yearly: karmic theme for the year
      - `chapters` HoroscopeChapter[], nullable: Yearly: chapter breakdown
        - `chapter_number` integer, required
        - `start_date` string, required: Chapter start date (YYYY-MM-DD)
        - `end_date` string, required: Chapter end date (YYYY-MM-DD)
        - `title` string, required
        - `theme` string, required
        - `narrative` string, required
      - `auspicious_months` string[], nullable: Yearly: top auspicious months by name
      - `landmark_dates` HoroscopeLandmarkDate[], nullable: Yearly: key dates with tone
        - `date` string, required: Landmark date (YYYY-MM-DD)
        - `event` string, required
        - `tone` string, required: Either favorable or challenging
    - `generated_at` string, nullable: ISO timestamp when the horoscope was generated (UTC)
    - `period_key` string, required: 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` string, required: Horizon: daily, weekly, monthly, or yearly
    - `moon_sign` string, required: Normalised English Moon sign slug

## Other responses

- `401`: Authentication failed
- `403`: Authorization failed
- `404`: Resource not found
- `413`: Payload too large
- `422`: Validation error
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream provider error
- `503`: Service unavailable

---

[API](https://skmtc.dev/asterwise/apis/asterwise-api.md) · [All operations](https://skmtc.dev/asterwise/apis/asterwise-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asterwise/apis/asterwise-api/revisions/3c4bbb1194e2?raw)