Hasta Backend
  1. public
  • 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
    • List all subscription plans (admin)
      GET
    • Edit a subscription plan (admin)
      PATCH
    • Edit a subscription plan (admin)
      PATCH
    • Sync a recurring plan with Razorpay
      POST
    • Sync a recurring plan with Razorpay
      POST
    • Create a coupon (admin)
      POST
    • List coupons (admin)
      GET
    • Get a coupon (admin)
      GET
    • Get a coupon (admin)
      GET
    • Edit a coupon (admin)
      PATCH
    • Edit a coupon (admin)
      PATCH
    • List redemptions for a coupon (admin)
      GET
    • List redemptions for a coupon (admin)
      GET
    • Create a recurring scheduled notification (admin)
      POST
    • List scheduled notifications (admin)
      GET
    • Pause a scheduled notification (admin)
      PATCH
    • Resume a paused scheduled notification (admin)
      PATCH
  • blogs
    • Admin - get all blogs
    • Admin - delete a blog
    • Get all blogs
    • Get blog categories
    • Admin - get blog categories (name + slug)
    • Admin - edit a blog
    • 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
    • Feature or unfeature a review
    • Get all featured reviews
  • events
    • Track a user event
    • Fetch all tracked events
  • notifications
    • Send broadcast notification
    • Send custom notification to a user
    • Send a test notification (deep link redirect check)
    • 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
    • Get my feature status
    • Update my intents
    • Update profile image
    • Update language preference
    • Update push notification preference
    • Update current location
    • Get my family members
    • Add a family member
    • Delete a family member
    • Update family member profile image
    • Admin - get user details with family
    • Update a family member's intents
    • Admin - list users
    • Admin - get subscribers list
    • Admin - get user details with family
    • Admin - delete user and all family members
    • 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 family member kundali
    • Get horoscope (daily / weekly / monthly)
  • 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
    • List marriage report history
    • Preview the price to upgrade a compatibility report to the full Marriage Report
    • Start the compatibility -> full Marriage Report upgrade purchase
    • Consume the upgrade purchase and regenerate the full Marriage Report
  • child
    • Generate child report (baby names + birth timing)
    • Like or unlike a suggested baby name
    • Get child report (names + timing)
  • dashboard
    • Dashboard overview stats
    • User growth time-series
    • Subscription distribution by plan
    • Top-up & one-time sales distribution
    • Recent activity feed
  • Health
    • Liveness check
  • panchang
    • Get today's panchang for the user's current location
  • festivals
    • List festivals for the user's regions
    • Festival detail with full linked puja vidhis
  • library
    • List library items
    • Library filter options
    • Library content types
    • List my favourite library items
    • Add a library item to favourites
    • Remove a library item from favourites
    • Admin - list library items (incl. drafts)
    • Admin - create a library item
    • Admin - get a library item (incl. drafts)
    • Admin - edit / publish a library item
    • Stream a library item's audio
    • Get a library item
  • mantras
    • List mantras
    • List my favourite mantras
    • Add a mantra to favourites
    • Remove a mantra from favourites
    • Admin - list mantras (incl. drafts)
    • Admin - create a mantra
    • Admin - get a mantra (incl. drafts)
    • Admin - edit / publish a mantra
    • Stream a mantra's chanting audio
    • Get a mantra
  • nandini
    • Send a message and/or image(s)/PDF(s) to Nandini (reply is streamed over WebSocket)
    • List my Nandini conversations
    • Get a conversation's messages
    • Delete a conversation
    • Edit a message you sent (ChatGPT-style)
    • Share one message as a PDF
  • payments
    • Validate a coupon code
    • Start a plan/report/topup purchase
    • Verify a completed Razorpay payment
    • Cancel a recurring subscription
    • Pause a recurring subscription
    • Resume a paused subscription
  • subscriptions
    • List my purchase history
    • Get one purchase's status
  • public
    • Get today's panchang for any location - no auth required
      GET
    • Free kundali preview - no auth, no account required
      POST
    • Search a place by name (keystroke-aware) - no auth required
      GET
    • Website kundali registration - creates a real account, no auth required
      POST
    • Resolve a place_id to full location + timezone - no auth required
      GET
    • Poll a website registration's full kundali report - no auth required
      GET
  • coupons
    • List currently applicable coupons
    • Get a currently applicable coupon
  • account-deletion
    • Request account & data deletion
  1. public

Poll a website registration's full kundali report - no auth required

GET
https://uat-api.hastaai.in/api/v1/public/kundali/status
public
Last modified:2026-09-10 09:53:30
Request: No auth. Query token (required) - the report_token returned by POST /public/kundali/register.
That registration endpoint returns an instant chart preview immediately, but the full narrative report (report_envelope including deeper_insights, yogas[], strength_map, R2-hosted chart images, narration_url) generates in the background and isn't ready yet at that point - this is how a website visitor (who has no login/session) checks back on it. Deliberately scoped: report_token only ever unlocks this ONE report, nothing else on the account - it is NOT a login token.
Success: 200 - identical shape to the authed GET /kundali (data.status, data.kundali_data populated only when status is done).
Errors: 404 - unknown/invalid token. 429 - too many status checks from this IP (>30 per 600s).

Request

Query Params

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 'https://uat-api.hastaai.in/api/v1/public/kundali/status?token=undefined'

Responses

🟢200OK
application/json
Successful Response
Bodyapplication/json

Example
{
    "success": true,
    "message": "Success",
    "data": {
        "kundali_key": "Kundali-12345",
        "status": "done",
        "birth_date": "1997-07-18",
        "birth_time": "14:30:00",
        "birth_place": "Kolkata, West Bengal",
        "kundali_data": {
            "confidence": "precise",
            "narration_url": "https://images.hastaai.in/narrations/kundali-12345.mp3",
            "charts": [
                {
                    "chart_type": "rashi",
                    "style": "north",
                    "image_url": "https://images.hastaai.in/charts/abc.webp",
                    "label": "Birth Chart (North Indian)"
                },
                {
                    "chart_type": "rashi",
                    "style": "south",
                    "image_url": "https://images.hastaai.in/charts/def.webp",
                    "label": "Birth Chart (South Indian)"
                }
            ],
            "sun_sign": "Cancer",
            "moon_sign": "Sagittarius",
            "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
                }
            },
            "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
                }
            ],
            "yogas": [
                {
                    "name": "Gaja Kesari Yoga",
                    "meaning": "A blessing of wisdom, respect and success - you carry a natural dignity that draws good people and opportunities."
                }
            ],
            "strength_map": {
                "strongest_signs": [
                    "Gemini",
                    "Libra",
                    "Taurus"
                ],
                "bindus_by_sign": {
                    "Aries": 27,
                    "Taurus": 31,
                    "Gemini": 44,
                    "Cancer": 26,
                    "Leo": 24,
                    "Virgo": 27,
                    "Libra": 33,
                    "Scorpio": 24,
                    "Sagittarius": 28,
                    "Capricorn": 27,
                    "Aquarius": 19,
                    "Pisces": 28
                }
            },
            "report_envelope": {
                "headline_score": 82,
                "score_label": "Strongly favourable",
                "verdict": "You are entering a warm, opportunity-rich phase - lead with your natural confidence and good things follow.",
                "highlights": [
                    "A standout year for career visibility",
                    "Deep, loyal relationships get stronger",
                    "Your health and energy are on the rise"
                ],
                "strengths": [
                    {
                        "title": "Natural communicator",
                        "text": "You put people at ease and explain ideas simply - a gift that opens doors in work and friendships."
                    }
                ],
                "challenges": [
                    {
                        "title": "You take on too much",
                        "text": "Your drive is real, but saying yes to everything can leave you drained.",
                        "solution": "Pick one priority each morning and protect it. Small, steady focus beats scattered effort."
                    }
                ],
                "life_areas": [
                    {
                        "area": "Career",
                        "text": "A strong year for visibility - say yes to the project that scares you a little."
                    }
                ],
                "technical_detail": "Lagna in Cancer with Moon in Rohini nakshatra; current Jupiter Mahadasha supports growth in the 10th house of career. Manglik dosha is absent.",
                "technical_breakdown": [
                    {
                        "heading": "House-by-House Breakdown",
                        "points": [
                            "1st House - Sagittarius (Moon): an emotional, truth-seeking nature with a restless energy that keeps pushing you to learn.",
                            "2nd House - Capricorn (Sun, Mercury retrograde): disciplined focus on wealth-building, though retrograde Mercury can delay financial decisions."
                        ]
                    }
                ],
                "confidence": "precise",
                "pending": [],
                "deeper_insights": {
                    "past_life": "Your chart's Saturn-Ketu placement suggests a past life shaped by discipline and service - themes of duty carried forward into how naturally you take responsibility now.",
                    "future_path": "The years ahead point toward growing recognition in your chosen field, with steady, earned progress rather than one big leap.",
                    "wellness": {
                        "areas_to_watch": [
                            "Digestion and gut sensitivity",
                            "Joint and bone health in later years"
                        ],
                        "remedies": [
                            "Offer water to the rising Sun on Sundays",
                            "Favour warm, easily-digestible foods",
                            "Keep a regular stretching or yoga routine"
                        ],
                        "disclaimer": "General astrological wellness guidance, not a medical diagnosis - please consult a doctor for any health concern."
                    },
                    "dos_and_donts": {
                        "dos": [
                            "Lead with your natural confidence in new opportunities",
                            "Keep your close relationships a daily priority"
                        ],
                        "donts": [
                            "Don't let a full calendar crowd out rest",
                            "Avoid snap financial decisions during Mercury retrograde"
                        ]
                    }
                }
            }
        },
        "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."
            }
        ]
    }
}
🟠404Record Not Found
🟠422Parameter Error
🟠429
Modified at 2026-09-10 09:53:30
Previous
Resolve a place_id to full location + timezone - no auth required
Next
List currently applicable coupons
Built with