Hasta Backend
  1. tarot
  • 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 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
    • Get single tarot card by slug
      GET
    • Get today's daily tarot card
      GET
    • Get a 3-card tarot reading
      POST
    • Get tarot reading history
      GET
  • 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. tarot

Get a 3-card tarot reading

POST
/api/v1/tarot/reading
tarot
Last modified:2026-06-04 22:55:16
Draws 3 random cards (Past / Present / Future) and generates an AI interpretation via Claude Sonnet. Real-time response (~4s) - this is synchronous, the full result is returned in the POST response (no polling). Saved permanently.
Request: Bearer token
Body: question (optional, max 300 chars)
Success: 200 - data contains reading_key (Tarot-XXXXX), cards[] (3 cards: position [Past/Present/Future], name, slug, image_url, orientation, meaning), and ai_interpretation (text).
Errors: 401 - invalid token | 404 - user not found

Request

Body Params application/json

Example
{
    "question": "What should I focus on in my career?"
}

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/tarot/reading' \
--header 'Content-Type: application/json' \
--data '{
    "question": "What should I focus on in my career?"
}'

Responses

🟢200OK
application/json
Successful Response
Bodyapplication/json

Example
{
    "success": true,
    "message": "Success",
    "data": {
        "reading_key": "Tarot-44290",
        "cards": [
            {
                "position": "Past",
                "name": "The Chariot",
                "slug": "the-chariot",
                "image_url": "https://images.hastaai.in/\n                                        tarot_images/the_chariot.png",
                "orientation": "upright",
                "meaning": "Victory, determination, willpower"
            },
            {
                "position": "Present",
                "name": "The Hierophant",
                "slug": "the-hierophant",
                "image_url": "https://images.hastaai.in/\n                                        tarot_images/the_hierophant.png",
                "orientation": "upright",
                "meaning": "Tradition, guidance, beliefs"
            },
            {
                "position": "Future",
                "name": "The Empress",
                "slug": "the-empress",
                "image_url": "https://images.hastaai.in/\n                                        tarot_images/the_empress.png",
                "orientation": "upright",
                "meaning": "Fertility, abundance, nurturing"
            }
        ],
        "ai_interpretation": "There was a time not long \n                                ago when you moved through life with extraordinary \n                                force and focus. The Chariot carried you forward on \n                                sheer willpower, and you achieved things that required \n                                real discipline and courage. You may have fought battles - \n                                internal or external - and emerged victorious, not because \n                                circumstances were easy, but because you refused to let \n                                them stop you. That drive shaped who you are, and the \n                                momentum you built during that chapter was not accidental. \n                                It was earned, and it left a mark on your character that \n                                still runs through everything you do.\n\nNow you find \n                                yourself in a different kind of energy - slower, more \n                                reflective, perhaps even structured in ways that feel \n                                unfamiliar after the fierce independence of your Chariot \n                                days. The Hierophant invites you to look beyond your own \n                                willpower and consider what wisdom already exists around you. \n                                This might mean leaning into a tradition, a teacher, a community, \n                                or even a deeply held belief system that is asking to be \n                                examined more honestly. It can feel like a pause or \n                                even a constraint, but it is actually an invitation \n                                to find meaning that goes deeper than victory. \n                                Something or someone is offering you guidance right \n                                now, and the question worth sitting with is whether \n                                you are open enough to receive it.\n\nWhat is being \n                                prepared for you in the future is genuinely beautiful. \n                                The Empress represents a richness of life that blooms \n                                naturally when the ground has been properly tended - \n                                and you have been tending it. After the striving of \n                                the Chariot and the grounding wisdom of the Hierophant, \n                                you are moving toward a season of abundance, creativity, \n                                and deep nourishment. This could manifest as creative \n                                work coming to fruition, relationships deepening \n                                with warmth, financial stability arriving more \n                                organically, or simply a felt sense of fullness \n                                replacing the hunger that once drove you so relentlessly \n                                forward.\n\nThe arc of this spread tells a story of someone \n                                learning that strength does not always look like conquest. \n                                You have proven you can fight and win. Now life is teaching \n                                you to receive wisdom with humility, so that what grows next \n                                comes not from force but from genuine flourishing. The \n                                Empress does not chase - she creates conditions and allows \n                                life to bloom. That is where you are headed, and it suits \n                                you more than you may yet realize."
    }
}
🟠401Unauthorized
🟠404Record Not Found
🟠422Parameter Error
Modified at 2026-06-04 22:55:16
Previous
Get today's daily tarot card
Next
Get tarot reading history
Built with