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

Get Face ID

Get Face ID is the starting point of the complete Face Reading flow. It scans the submitted facial image, extracts the face-reading data, stores the analysis, and returns a unique face_id. This ID becomes the reference key for every other Face Analysis and Face Reading APIs.

The image can be supplied through a public image URL or base64 image data. The API supports common image formats such as JPEG, JPG, PNG, and WEBP, with a maximum image size of 5 MB. Birth details such as `day`, `month`, `year`, and `gender` can also be sent together when those details are available.

A successful response returns the `face_id`. Store this value with the user's reading because the same ID is passed to all remaining APIs.
POSThttps://vision.astrologyapi.com/face-reading/get-face-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. If birth details are supplied, day, month, year, and gender must all be valid.

monthnumberrequired

Month of birth.

yearnumberrequired

Year of birth.

genderstringrequired

Gender value used with optional birth details.

Submit a face image URL, base64 image, or uploaded image. Optional day, month, year, and gender can be supplied together.
Next →
Mask Outline Image
curl --location 'https://vision.astrologyapi.com/face-reading/get-face-id' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "image_url": "https://sample-image.jpg",
    "day": 15,
    "month": 8,
    "year": 1995,
    "gender": "male"
}'
Try it

Runs with sample data — no API key needed

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