šŸ•°ļø 15+ Muhurta APIs and āœ‹ Palmistry API are now live. Ship them in your app today.

Processed Palm Image

You must provide a valid palm_id to call this API. How to get Palm ID →
The Processed Palm Image API returns the processed palm image connected with the stored palm_id. It represents the visual-output part of the palmistry flow instead of returning another life-category interpretation.

This image can support the reading interface by showing the processed result associated with the original scan. It keeps the visual palm output tied to the same record used by the structured analysis and reading APIs.

This API forms the final visual layer of the Palmistry product flow. The structured JSON explains the hand, lines, mounts, features, and life categories, while the processed palm image gives the corresponding visual result for presentation in the application.
POSThttps://vision.astrologyapi.com/palmistry/get-palm-image

Authentication

x-astrologyapi-keystringrequired

API access token used to authenticate requests. Send your access token in this custom header.

Accept-Languagestring

Preferred language for the response content. Supported: English - en.

Body parameters

palm_idstringrequired

Unique palm reading ID returned by get-palm-id

Detect and overlay palm lines on a palm photo supplied via URL.
curl --location 'https://vision.astrologyapi.com/palmistry/get-palm-image' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "palm_id": "c48d0b80-1d49-4af8-8c05-e778b3d7a00f"
}'
Try it

Runs with sample data — no API key needed

{
  "status": true,
  "message": "success",
  "data": {
    "palm_id": "9f1c1234-5678-90ab-cdef-1234567890ab",
    "overlay_image_url": "https://pub-xxxx.r2.dev/9f1c1234..._processed.png",
    "original_image_url": "https://sample-image.jpg",
    "processing_model": "palm-lines-v1.4",
    "lines_detected": [
      {
        "name": "Heart Line",
        "color": "#FF0000",
        "present": true,
        "confidence": 0.82
      },
      {
        "name": "Head Line",
        "color": "#0000FF",
        "present": true,
        "confidence": 0.71
      },
      {
        "name": "Life Line",
        "color": "#00FF00",
        "present": true,
        "confidence": 0.9
      },
      {
        "name": "Fate Line",
        "color": "#FFFF00",
        "present": true,
        "confidence": 0.12
      }
    ],
    "Heart Line Confidence": 0.82,
    "Head Line Confidence": 0.71,
    "Life Line Confidence": 0.9,
    "Fate Line Confidence": 0.12
  }
}