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

Face Outline

You must provide a valid face_id to call this API. How to get Face ID →
Face Outline API records distinctive visible details found across the face. Instead of describing the general facial shape, it focuses on marks and noticeable external features.

The response can include arrays such as `moles`, `scars`, and `distinct_features`. A distinct feature can include a visible item or characteristic identified in the image, while moles and scars are returned separately when detected.

This API gives the application an additional layer of detailed face observations and helps preserve unique visual characteristics from the original scan.
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

Fetch face outline details for a stored face reading.
← 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"
    ]
  }
}