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

Get Palm ID

Reads a palm photo with an AI vision model, extracts structured palm features (hand type, lines, mounts, special marks) and stores them. Returns a palm_id used by all other palm scanner endpoints. Category readings (career, love, money, etc.) are not generated here - they are generated on demand by their own getter endpoints.
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.

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"
  }
}