🌍 Astrocartography API, 🔷 Human Design API and ✋ Palmistry API are now live. Ship them in your app today.

Processed Palm Image

Runs a computer-vision model on an image URL, draws the detected heart, head, life and fate lines on the photo, and returns the overlay image URL with per-line confidence scores. Image validation: accepted formats are JPEG/JPG and PNG. Maximum image size is 5MB (configurable) - larger files are rejected with 400. The image is checked for blurriness; images scoring below are rejected
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

← Previous
Luck
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
  }
}