Yearly Bhavishyafal (Annual Horoscope)

Generate a personalized yearly horoscope for any user — powered by a deep authored Vedic narrative corpus.

Not sun-sign generics. A real kundli-based annual forecast in a single API call.

What you'll build

A personalized yearly horoscope with up to 14 authored sections
Varshaphal themes (Muntha + Varsha Lord) for the year's overall tone
Active Vimshottari dasha analysis at the solar return moment
Sade Sati phase warning if applicable
Slow-mover transit narratives (Jupiter, Saturn, Rahu/Ketu, Mars)
Marriage, career, and finance outlook sections

Build this with AI

Copy the full prompt below, paste it into ChatGPT, Claude, Cursor, or Lovable, and get a working Next.js implementation in minutes. No coding skill required.

92 lines Structured context With API endpoints

Step by step

01One call — /vedic/narrative/yearly-bhavishyafal

Pass the user's birth data and the target year. The endpoint anchors all calculations to the solar return moment (when the Sun returns to its natal longitude) and returns up to 14 sections drawn from our deep authored corpus — no prompt engineering, no AI hallucinations.

GET /v1/vedic/narrative/yearly-bhavishyafal

curl "https://api.lifeastroapi.com/v1/vedic/narrative/yearly-bhavishyafal?birth.date=1990-05-10&birth.time=19%3A55&birth.tz=%2B05%3A30&lat=19.06&lon=72.88&year=2027" \
  -H "Authorization: Bearer YOUR_API_KEY"

example response

{
  "sections": [
    {
      "rule_id": "vedic.L2.varshaphal.muntha_in_9",
      "axis": "varshaphal",
      "heading": "Muntha in the 9th House — Fortune and Long Journeys",
      "body": "The Muntha falling in the 9th house this year activates dharma, higher education…"
    },
    {
      "rule_id": "vedic.L2.dasha.venus_mercury_sun",
      "axis": "dasha",
      "heading": "Venus–Mercury–Sun Period",
      "body": "This Venus mahadasha period with Mercury antardasha brings artistic expression…"
    },
    { "axis": "transit", "heading": "Jupiter Transiting Gemini", "body": "…" },
    { "axis": "outlook", "heading": "Career Outlook", "body": "…" },
    "… up to 14 sections"
  ],
  "tier": "silver"
}

02Display sections as accordions or cards

Each section has a `heading` and `body`. Render them as expandable cards grouped by axis: varshaphal themes first, then dasha, then sade-sati (if present), then transits, then outlooks. The order returned is already the recommended display order.

03Add year navigation

Let users browse past and future years. The API supports any year from 1900 to 2100. Cache per (birth-data + year) since the horoscope only changes when the year changes.