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

Face Shape

You must provide a valid face_id to call this API. How to get Face ID →
Face Shape API returns the overall structural shape detected from the stored face. It describes how the width and length of the face relate to each other and identifies the broader facial form, such as an oblong or other detected shape.

The response can contain fields such as `type`, `width_to_length`, and `five_element_type`. The Five Element classification connects the facial structure with traditional face-reading systems, where forms can be associated with elemental patterns such as Wood, Fire, Earth, Metal, or Water.
POSThttps://vision.astrologyapi.com/face-reading/shape

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

face_idstringrequired

Unique face reading ID returned by get-face-id

Fetch face shape details for a stored face reading.
← Previous
Mask Outline Image
Next →
Eyes
curl --location 'https://vision.astrologyapi.com/face-reading/shape' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "face_id": "c48d0b80-1d49-4af8-8c05-e778b3d7a00f"
}'
Try it

Runs with sample data — no API key needed

{
  "status": true,
  "data": {
    "type": "oblong",
    "width_to_length": "longer",
    "five_element_type": "wood"
  }
}