Get-palm-id | AstrologyAPI Developers

Get Palm ID

POSThttps://vision.astrologyapi.com/palmistry/get-palm-id

Copy

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.

POST/get-palm-id

Copy

1curl --location 'https://vision.astrologyapi.com/palmistry/get-palm-id' \
2  --header 'Content-Type: application/json' \
3  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
4  --data '{
5    "image_url": "https://sample_image.jpg"
6}'
7

200Response

Copy

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

Request Headers

x-astrologyapi-key

string

required

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

Accept-Language

string

Preferred language for the response content

Properties

English - en

Request Body (JSON)

image_url

string

required

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

Properties

jpegjpgpng

Request Description

Submit a palm photo (public URL or base64 data URL) to start a new palm reading.

Errors

400

Bad Request

Something is wrong with your request format or parameters.

401

Unauthorized

Your API key is missing or invalid.

403

Forbidden

You don't have permission to access this specific resource.

404

Not Found

The API endpoint you're trying to reach doesn't exist.

500

Internal Server Error

Our server is having a temporary glitch.

POST/get-palm-id

Copy

1curl --location 'https://vision.astrologyapi.com/palmistry/get-palm-id' \
2  --header 'Content-Type: application/json' \
3  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
4  --data '{
5    "image_url": "https://sample_image.jpg"
6}'
7

200Response

Copy

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

Hand Type