Hasta Backend
  1. horoscopes
  • lookup
    • Get localised seed data
      GET
    • Get core seed data
      GET
    • Get zodiac signs
      GET
    • Get subscription and pricing plans
      GET
    • Get FAQs
      GET
    • Get notification intervals
      GET
  • audit
    • Get audit logs
      GET
  • auth
    • Register device
      POST
    • Send OTP
      POST
    • Verify OTP and login
      POST
    • Resend OTP
      POST
    • Refresh access token
      POST
    • Logout
      POST
    • Google OAuth login
      POST
  • admin
    • Register admin account
      POST
    • Admin login
      POST
    • Admin logout
      POST
    • Refresh admin access token
      POST
    • Get admin profile
      GET
    • Update admin password
      PUT
    • Edit language
      PUT
    • Add language
      POST
    • Delete language
      DELETE
    • Delete user event logs
      DELETE
    • Clear lookup cache
      DELETE
    • Clear cache
      DELETE
  • blogs
    • Admin - get all blogs
    • Admin - delete a blog
    • Get all blogs
    • Get blog categories
    • Update blog status
    • Admin - send blog notification
    • Get blog details
    • Subscribe to blog notifications
    • Unsubscribe from blog notifications
  • feedback
    • Submit a user feedback
    • Get all queries
    • Update user query status
    • Get all reviews
    • Update review status
    • Get all featured reviews
  • events
    • Track a user event
    • Fetch all tracked events
  • notifications
    • Send broadcast notification
    • Send custom notification to a user
    • Fetch user notifications
    • Get unread notification count
    • Mark notification as read
  • reminders
    • Fetch user reminders
    • Create a reminder
    • Update a reminder
    • Delete a reminder
  • user
    • Create / complete user profile
    • Get my profile
    • Update profile image
    • Update language preference
    • Update push notification preference
    • Get my family members
    • Add a family member
    • Delete a family member
    • Update family member profile image
    • Admin - list users
    • Admin - get user details with family
    • Admin - delete user and all family members
    • Create / complete user profile
    • Admin - update user status
  • palm
    • Get user palm reading
    • Upload user palm image
    • Upload family member palm image
    • Get family member palm reading
  • horoscopes
    • Get user kundali
      GET
    • Get family member kundali
      GET
    • Get horoscope (daily / weekly / monthly)
      GET
  • reports
    • Share a report via email
    • Get shared report PDF link
  • tarot
    • List all tarot cards
    • Get single tarot card by slug
    • Get today's daily tarot card
    • Get a 3-card tarot reading
    • Get tarot reading history
  • marriage
    • Generate marriage compatibility report
    • Get marriage compatibility report
  • child
    • Generate baby names or child timing
    • Like or unlike a suggested baby name
    • Get child naming or timing result
  • dashboard
    • Dashboard overview stats
    • User growth time-series
    • Subscription distribution by plan
    • Top-up & one-time sales distribution
    • Recent activity feed
  • Health
    • Liveness check
  1. horoscopes

Get user kundali

GET
/api/v1/kundali
horoscopes
Last modified:2026-06-04 22:55:16
Returns the authenticated user's Vedic birth chart and AI-generated report. The generated payload (charts, lagna, planets, dasha, AI report) is nested under a single kundali_data object: it is populated only when status=done and is null for every other status, so the frontend can check that one key instead of each field. north_chart_url / south_chart_url live inside kundali_data - frontend toggles between North/South Indian style.
Request: Bearer token
Body: none
Success: 200 - always returns kundali_key, status, zodiac_sign, birth_date, birth_time, birth_place, plus:
status: "done" - kundali_data object: north_chart_url, south_chart_url, lagna, planets, moon_nakshatra, vimshottari_dasha, ai_report
status: "pending"/"processing"/"failed"/"not_generated" - kundali_data: null
Errors: 401 - invalid token | 404 - profile not found

Request

None

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/kundali'

Responses

🟢200OK
application/json
Successful Response
Bodyapplication/json

Examples
{
    "success": true,
    "message": "Success",
    "data": {
        "kundali_key": "Kundali-41963",
        "status": "done",
        "zodiac_sign": "Aquarius",
        "birth_date": "1995-01-28",
        "birth_time": "04:13:00",
        "birth_place": "Kolkata",
        "kundali_data": {
            "north_chart_url": "https://images.hastaai.in/\n                                kundali/charts/d89634e4-d64a-44c8-b2b8-95c401323e75",
            "south_chart_url": "https://images.hastaai.in/\n                                kundali/charts/724bcfcc-5a50-4c89-9647-9afe484cbde6",
            "lagna": {
                "degree": 252.7281,
                "sign": "Sagittarius",
                "sign_num": 9,
                "nakshatra": "Mula",
                "pada": 4
            },
            "planets": {
                "Sun": {
                    "degree": 285.1857,
                    "sign": "Capricorn",
                    "sign_num": 10,
                    "house": 2,
                    "nakshatra": "Shravana",
                    "nakshatra_lord": "Moon",
                    "retrograde": false
                },
                "Ketu": {
                    "degree": 17.9957,
                    "sign": "Aries",
                    "sign_num": 1,
                    "house": 5,
                    "nakshatra": "Bharani",
                    "nakshatra_lord": "Venus",
                    "retrograde": false
                },
                "Mars": {
                    "degree": 126.2074,
                    "sign": "Leo",
                    "sign_num": 5,
                    "house": 9,
                    "nakshatra": "Magha",
                    "nakshatra_lord": "Ketu",
                    "retrograde": true
                },
                "Moon": {
                    "degree": 244.7945,
                    "sign": "Sagittarius",
                    "sign_num": 9,
                    "house": 1,
                    "nakshatra": "Mula",
                    "nakshatra_lord": "Ketu",
                    "retrograde": false
                },
                "Rahu": {
                    "degree": 197.9957,
                    "sign": "Libra",
                    "sign_num": 7,
                    "house": 11,
                    "nakshatra": "Swati",
                    "nakshatra_lord": "Rahu",
                    "retrograde": true
                },
                "Venus": {
                    "degree": 238.915,
                    "sign": "Scorpio",
                    "sign_num": 8,
                    "house": 12,
                    "nakshatra": "Jyeshtha",
                    "nakshatra_lord": "Mercury",
                    "retrograde": false
                },
                "Saturn": {
                    "degree": 318.2708,
                    "sign": "Aquarius",
                    "sign_num": 11,
                    "house": 3,
                    "nakshatra": "Shatabhisha",
                    "nakshatra_lord": "Rahu",
                    "retrograde": false
                },
                "Jupiter": {
                    "degree": 227.3379,
                    "sign": "Scorpio",
                    "sign_num": 8,
                    "house": 12,
                    "nakshatra": "Jyeshtha",
                    "nakshatra_lord": "Mercury",
                    "retrograde": false
                },
                "Mercury": {
                    "degree": 298.5778,
                    "sign": "Capricorn",
                    "sign_num": 10,
                    "house": 2,
                    "nakshatra": "Dhanishtha",
                    "nakshatra_lord": "Mars",
                    "retrograde": true
                }
            },
            "moon_nakshatra": {
                "index": 18,
                "name": "Mula",
                "pada": 2,
                "lord": "Ketu",
                "degree": 244.7945
            },
            "vimshottari_dasha": [
                {
                    "planet": "Ketu",
                    "start_date": "1995-01-28",
                    "end_date": "1999-07-23",
                    "years": 4.48
                },
                {
                    "planet": "Venus",
                    "start_date": "1999-07-23",
                    "end_date": "2019-07-23",
                    "years": 20
                },
                {
                    "planet": "Sun",
                    "start_date": "2019-07-23",
                    "end_date": "2025-07-22",
                    "years": 6
                },
                {
                    "planet": "Moon",
                    "start_date": "2025-07-22",
                    "end_date": "2035-07-22",
                    "years": 10
                },
                {
                    "planet": "Mars",
                    "start_date": "2035-07-22",
                    "end_date": "2042-07-21",
                    "years": 7
                },
                {
                    "planet": "Rahu",
                    "start_date": "2042-07-21",
                    "end_date": "2060-07-20",
                    "years": 18
                },
                {
                    "planet": "Jupiter",
                    "start_date": "2060-07-20",
                    "end_date": "2076-07-20",
                    "years": 16
                },
                {
                    "planet": "Saturn",
                    "start_date": "2076-07-20",
                    "end_date": "2095-07-20",
                    "years": 19
                },
                {
                    "planet": "Mercury",
                    "start_date": "2095-07-20",
                    "end_date": "2112-07-20",
                    "years": 17
                }
            ],
            "ai_report": {
                "personal_growth": "With your Lagna \n                                    and Moon both in Mula nakshatra, \n                                    ruled by Ketu, you are a soul fundamentally oriented toward \n                                    unraveling deep truths and dismantling illusions. \n                                    This placement creates an intense inner drive \n                                    to question existence itself. The Sagittarian \n                                    ascendant amplifies philosophical seeking \n                                    and spiritual restlessness. \n                                    During your Ketu Mahadasha, profound inner transformations \n                                    occur, often through loss or detachment. \n                                    Jupiter and Venus in Scorpio's \n                                    twelfth house deepen your mystical inclinations. \n                                    Embrace solitude as sacred rather than isolating. \n                                    Your greatest growth emerges not from accumulation \n                                    but from releasing what no longer serves your \n                                    authentic spiritual evolution and higher purpose.",
                "career": "Sun and Mercury in Capricorn's \n                                    second house create a foundation oriented \n                                    toward financial stability, communication, \n                                    and structured resource-building, \n                                    though Mercury retrograde suggests unconventional \n                                    thinking that may initially face resistance before \n                                    proving visionary. Mars retrograde in Leo's \n                                    ninth house in Magha nakshatra indicates \n                                    powerful ambitions in higher education, \n                                    law, publishing, or philosophical fields, \n                                    though progress may feel delayed or internally \n                                    redirected. Saturn in Aquarius third house \n                                    gifts disciplined communication and persistence. \n                                    Careers involving research, occult sciences, \n                                    psychology, spiritual teaching, or investigative \n                                    journalism suit you powerfully. Financial rewards \n                                    often arrive after considerable foundational \n                                    effort and patience through your earlier years.",
                "love_relationships": "Jupiter and Venus conjunct \n                                    in Scorpio's twelfth house creates a deeply \n                                    private, intensely romantic, and spiritually \n                                    charged approach to love. Relationships hold \n                                    transformative power in your life but often unfold \n                                    in hidden, unconventional, or karmatically complex \n                                    circumstances. You seek profound soul-level \n                                    connection rather than surface compatibility. \n                                    Ketu in Aries fifth house creates some detachment \n                                    or unpredictability around romance, children, and \n                                    creative expression. Rahu in Libra eleventh house in \n                                    Swati nakshatra draws you toward relationships that \n                                    expand your social network and worldview. True \n                                    partnership flourishes when both individuals \n                                    honor depth, privacy, and mutual philosophical or \n                                    spiritual growth rather than conventional expectations.",
                "health_wellbeing": "Mula nakshatra ruling \n                                    both your ascendant and Moon creates a constitution \n                                    sensitive to the nervous system, digestive root, \n                                    and hips or thighs as Sagittarius governs these \n                                    regions. Ketu's strong influence may manifest \n                                    as mysterious or difficult-to-diagnose health \n                                    concerns, particularly affecting immunity or \n                                    neurological function during its Mahadasha period. \n                                    Jupiter and Venus in the twelfth house suggest benefit \n                                    from retreat, rest, and restorative spiritual practices \n                                    such as yoga, meditation, or time in nature. Mars \n                                    retrograde in Leo's ninth house warns against \n                                    overexertion or inflammation. Prioritizing \n                                    grounding practices, adequate sleep, and avoiding \n                                    extremes in diet will significantly support your \n                                    overall vitality and energetic balance."
            }
        }
    }
}
🟠401Unauthorized
🟠404Record Not Found
Modified at 2026-06-04 22:55:16
Previous
Get family member palm reading
Next
Get family member kundali
Built with