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

Eyes

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

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