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

Proportions

You must provide a valid face_id to call this API. How to get Face ID →
Proportions API analyses how the main sections of the face relate to one another. It looks at larger facial ratios instead of individual features, giving the reading engine a structural map of the face.

The response can contain fields such as `vertical_thirds` and `eye_spacing_fifths`. These measurements relate to classical facial proportion systems and help show whether the upper, middle, or lower facial regions are more dominant and how the eyes sit across the facial width.

Proportion data provides useful context for Three Courts style interpretation, balance analysis, personality readings, and broader life-stage themes.
POSThttps://vision.astrologyapi.com/face-reading/proportions

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 facial proportions details for a stored face reading.
← Previous
Symmetry
Next →
Facial Hair
curl --location 'https://vision.astrologyapi.com/face-reading/proportions' \
  --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": {
    "vertical_thirds": "lower dominant",
    "eye_spacing_fifths": "balanced"
  }
}