🌍 Astrocartography API and ✋ Palmistry API are now live. Ship them in your app today.Get Started

Face Outline

Returns the stored face outline observations for a previously scanned face.
POSThttps://vision.astrologyapi.com/face-reading/face-outline

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
Facial Hair
Next →
Career Reading
curl --location 'https://vision.astrologyapi.com/face-reading/face-outline' \
  --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": {
    "moles": [],
    "scars": [],
    "distinct_features": [
      "earring on right ear lobe"
    ]
  }
}