Get horoscope (daily / weekly / monthly)

Request: No body - auth token only. Query period (daily default | weekly | monthly) and system (vedic default | western).

Returns the horoscope for the requested period. system selects the zodiac convention: vedic uses the Moon sign / Janma Rashi (what Indian rashifal uses, falling back to the Sun sign until the kundali is ready), western uses the tropical Sun sign from DOB. One endpoint replaces the old daily/weekly/monthly routes.

If the prediction is not generated yet, generation is kicked off in the background (once per sign/year) and the response is status: processing; poll until status: done.

Success: 200 - always returns zodiac_sign, status and a glossary[] explaining Sun sign vs Vedic Moon sign. The whole generated payload nests under the single horoscope_data object - populated when status is done, null otherwise, so check one field instead of many. When done, horoscope_data contains: title, prediction, love_prediction, health_prediction, career_prediction, finance_prediction, lucky_color, lucky_number, lucky_time (plus top-level prediction_date for daily).

States: done (horoscope_data populated) | processing (generation in progress, poll again; horoscope_data null) | failed (errored; poll again to retry; horoscope_data null).

Errors: 401 invalid/missing token | 404 profile or zodiac sign not set | 422 invalid period/system value.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Examples

GeneratedStill generatingFailed - poll again to retry

{
    "success": true,
    "message": "Success",
    "data": {
        "zodiac_sign": "Cancer",
        "prediction_date": "2026-05-29",
        "status": "done",
        "horoscope_data": {
            "title": "A Day of Renewal",
            "prediction": "The stars align in your favour today. Embrace new beginnings.",
            "love_prediction": "Romance is in the air - express your feelings openly.",
            "health_prediction": "Light exercise will boost your energy levels.",
            "career_prediction": "A creative solution impresses your peers.",
            "finance_prediction": "Avoid impulsive purchases today.",
            "lucky_color": "Blue",
            "lucky_number": 7,
            "lucky_time": "Morning 7-9 AM"
        },
        "glossary": [
            {
                "slug": "nakshatra",
                "term": "Nakshatra",
                "meaning": "The Moon's 'star home' among 27 lunar mansions. It colours the day's energy and your natural instincts."
            }
        ]
    }
}

🟠401Unauthorized

🟠404Record Not Found

🟠422Parameter Error

Get horoscope (daily / weekly / monthly)

Request

Request Code Samples

Responses