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

Face Shape

Returns the stored face shape observations for a previously scanned face.
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

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