🕰️ 15+ Muhurta APIs and ✋ Palmistry API are now live. Ship them in your app today.

Get Palm ID

This is the starting API for the complete palmistry flow. It reads the submitted palm image with a vision model and creates one stored palm-reading record. The request includes image_url, date of birth through day, month, and year, and the person’s gender. The image can be sent through a public URL or a base64 data URL.

The scan extracts the core palm structure, including hand type, palm lines, mounts, finger features, and special markings. The response returns a unique palm_id. This same ID connects the original image with every later analysis and reading endpoint.

In palmistry terms, this step creates the base hand profile. It establishes the physical features that later APIs interpret through the Heart Line, Head Line, Life Line, Fate Line, Mounts, finger structure, elemental hand type, and visible palm markings.
POSThttps://vision.astrologyapi.com/palmistry/get-palm-id

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

image_urlstringrequired

Public image URL or base64 data URL (data:image/...;base64,...) of the palm photo. Aliases: url, img_url, image. Accepted formats: jpeg, jpg, png, webp. Maximum size: 5MB.

daynumberrequired

Day of birth.

monthnumberrequired

Month of birth.

yearnumberrequired

Year of birth.

genderstringrequired

Gender of the user.

Submit a palm photo (public URL or base64 data URL) to start a new palm reading.
Next →
Hand Type
curl --location 'https://vision.astrologyapi.com/palmistry/get-palm-id' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "image_url": "https://sample_image.jpg",
    "day": "30",
    "month": "7",
    "year": "2000",
    "gender": "male"
}'
Try it

Runs with sample data — no API key needed

{
  "status": true,
  "message": "success",
  "data": {
    "palm_id": "c48d0b80-1d49-4af8-8c05-e778b3d7a00f"
  }
}