Get horoscope (daily / weekly / monthly)

Returns the horoscope for the authenticated user's sun sign for the requested period. One endpoint replaces the old daily/weekly/monthly routes - switch via the period query param.

If the prediction has not been generated yet, generation is kicked off in the background (once per sign/year) and the response is status: processing. The client should poll this endpoint until status: done, at which point the full prediction is returned.

Request: Bearer token

Query params:

period (optional, default daily) - one of daily | weekly | monthly

Body: none

Success: 200

status: "done" - zodiac_sign, title, prediction, love_prediction, health_prediction, career_prediction, finance_prediction, lucky_color, lucky_number, lucky_time (plus prediction_date for daily)

status: "processing" - zodiac_sign only; generation in progress, poll again shortly

status: "failed" - generation errored; zodiac_sign only. Retry by polling again (a fresh generation is kicked off).

Errors: 401 - invalid/expired token | 404 - profile or zodiac sign not set | 422 - invalid period value

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Examples

GeneratedStill generatingFailed - poll again to retry

{
    "success": true,
    "message": "Success",
    "data": {
        "status": "done",
        "zodiac_sign": "Cancer",
        "prediction_date": "2026-06-02",
        "title": "A Day of Renewal",
        "prediction": "The stars align in your favour today.",
        "lucky_color": "Blue",
        "lucky_number": 7,
        "lucky_time": "Morning 7-9 AM"
    }
}

🟠401Unauthorized

🟠404Record Not Found

🟠422Parameter Error

Get horoscope (daily / weekly / monthly)

Request

Request Code Samples

Responses