API Documentation

Palm Report

You must provide a valid palm_id to call this API. How to get Palm ID →

The Palm Report API creates a complete A4 PDF reading from the palm stored under the palm_id. It combines the palm image, hand type, fingers, major and minor lines, mounts, special markings, and life-area readings into one downloadable report.

The API accepts the request immediately and returns a request_id. When the report is ready, the PDF link is delivered by a POST request to the supplied webhook_url. Send language as hi for a Hindi report; en is the default.

This API forms the full-report layer of the Palmistry API. It converts the stored palm analysis into a formatted report covering personality, career, wealth, love, marriage, health, growth, luck, and practical next steps.

POSThttps://vision.astrologyapi.com/palmistry/palm-report

Parameters

Parameter	Type	Description
palm_idrequired	string	Palm ID returned by Get Palm ID
webhook_urlrequired	string	Public HTTPS webhook URL that receives the completed report
name	string	Optional name printed on the report cover and page headers; maximum 60 characters
language	string	Optional report language: en (default) or hi for Hindi

Sample PDFs

Palm Report PDF Samples

Download a sample palm reading report in English or Hindi.

English PDF SampleDownload PDF

Hindi PDF SampleDownload PDF

Supported Languages

enhi

Request

{
  "palm_id": "c48d0b80-1d49-4af8-8c05-e778b3d7a00f",
  "webhook_url": "https://your-domain.com/palm-webhook",
  "name": "Priya Verma",
  "language": "hi"
}

Code samples

curl --location 'https://vision.astrologyapi.com/palmistry/palm-report' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'Authorization: Basic <YOUR_API_KEY>' \
  --data 'palm_id=c48d0b80-1d49-4af8-8c05-e778b3d7a00f&webhook_url=https%3A%2F%2Fyour-domain.com%2Fpalm-webhook&name=Priya%20Verma&language=hi'

Response

{
  "status": true,
  "message": "Your report is being generated",
  "request_id": "abff62ec-1259-43dd-bf8e-241469d6fd16"
}

Webhook payload

When the PDF is ready, a POST request with the following JSON body is sent to the webhook_url supplied in your report request. This callback is separate from the initial API response, which confirms that report generation has started.

Use request_id to match the callback to your original request. The pdf_url points to the completed report, and sent_at is the UTC timestamp when the callback was sent. Example completion payload:

{
  "event": "palm_report.completed",
  "request_id": "d3cc51d9-edd0-4d63-878f-3f8b91412f3e",
  "palm_id": "0eab0be4-b42b-4370-872d-54b221e78647",
  "status": true,
  "pdf_url": "https://pub-25798a11dfd546a4b6764f1fd24e5cc5.r2.dev/0eab0be4-b42b-4370-872d-54b221e78647_report_6e5aec860361.pdf",
  "sent_at": "2026-10-21T14:33:08Z"
}