Get user palm reading

Poll this after POST /palm/user. Always returns HTTP 200 with a status field; poll until done or failed.

Request: Bearer token

Body: none

Success: 200 - body always contains status. Fields by state:

status: "not_uploaded" - no palm image on file yet; show the upload CTA. No other fields.

status: "pending" - image uploaded, analysis queued. palm_image_url present; reading is null.

status: "processing" - Claude Vision analysing. palm_image_url present; reading is null.

status: "done" - palm_image_url plus reading: personality, love_life, career, health, lifespan_indicators, key_lines (heart/head/life/fate), yearly_prediction.

status: "failed" - analysis errored; allow re-upload/retry. palm_image_url present; reading is null.

Errors: 401 - invalid/expired token | 404 - user not found

application/json

Successful Response

Bodyapplication/json

{
    "success": true,
    "message": "Success",
    "data": {
        "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 a 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."
        }
    }
}

Request

Request Code Samples

Responses