Hasta Backend
  1. palm
  • 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
      GET
    • Upload user palm image
      POST
    • Upload family member palm image
      POST
    • Get family member palm reading
      GET
  • 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
  • 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
    • Free kundali preview - no auth, no account required
    • Search a place by name (keystroke-aware) - no auth required
    • Resolve a place_id to full location + timezone - no auth required
  • coupons
    • List currently applicable coupons
    • Get a currently applicable coupon
  • account-deletion
    • Request account & data deletion
  1. palm

Get family member palm reading

GET
https://uat-api.hastaai.in/api/v1/palm/family/{family_key}
palm
Last modified:2026-08-13 18:45:26
Same state machine as GET /palm/user, scoped to a family member. Always returns HTTP 200 with a status field; poll until done or failed.
Request: No body - auth token only. Path family_key (Family-XXXXX).
Success: 200 - body always contains status. States:
not_uploaded - no image for this member; show upload CTA. palm_key is null.
pending / processing - palm_image_url present, reading is null.
done - palm_image_url plus the whole payload under the single reading object (incl. confidence, positivity_score, report_envelope, narration_url) - same shape as GET /palm/user.
failed - analysis errored; allow re-upload.
Errors: 401 invalid/missing token | 404 family member not found for this user.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path 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/palm/family/' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK
application/json
Successful Response
Bodyapplication/json

Examples
{
    "success": true,
    "message": "Success",
    "data": {
        "palm_key": "Palm-2322",
        "status": "done",
        "palm_image_url": "https://cdn.hastaai.in/palms/user-12345.jpg",
        "reading": {
            "personality": "You possess strong leadership qualities and natural charisma.",
            "love_life": "Deep emotional bonds define your relationships.",
            "career": "Creative fields and entrepreneurship suit you well.",
            "health": "Good overall vitality with attention needed for stress.",
            "lifespan_indicators": "Strong life line suggests robust constitution.",
            "key_lines": {
                "heart": "Long curved line - deeply emotional.",
                "head": "Straight line - analytical mind.",
                "life": "Strong line - good vitality.",
                "fate": "Clear line - structured path."
            },
            "yearly_prediction": "2026 brings new opportunities in career and personal growth.",
            "confidence": "precise",
            "positivity_score": 82,
            "narration_url": "https://images.hastaai.in/narrations/palm-2322.mp3",
            "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": []
            }
        }
    }
}
🟠401Unauthorized
🟠404Record Not Found
🟠422Parameter Error
Modified at 2026-08-13 18:45:26
Previous
Upload family member palm image
Next
Get user kundali
Built with