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

Eyes

You must provide a valid face_id to call this API. How to get Face ID →
Eyes API returns detailed observations about the person's eyes from the stored face scan. It describes visible qualities such as eye size, shape, spacing, expression, brightness, and the appearance of the eye whites.

Fields can include `size`, `shape`, `spacing`, `shen_brightness`, `expression`, and `whites`. In traditional Mian Xiang terminology, Shen refers to the visible spirit or vitality expressed through the eyes, so this field adds a traditional face-reading layer to the physical observations.

Eye data is especially important for readings related to personality, emotional expression, vitality, relationships, and general temperament.
POSThttps://vision.astrologyapi.com/face-reading/eyes

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 eye details for a stored face reading.
← Previous
Face Shape
Next →
Nose
curl --location 'https://vision.astrologyapi.com/face-reading/eyes' \
  --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": {
    "size": "medium",
    "shape": "almond",
    "spacing": "normal",
    "shen_brightness": "calm",
    "expression": "observant",
    "whites": "clear"
  }
}