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

Mask Outline Image

Returns a processed face image URL with mask outline data and detected traits for a previously scanned face.
POSThttps://vision.astrologyapi.com/face-reading/mask-outline-image

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
Get Face ID
Next →
Face Shape
curl --location 'https://vision.astrologyapi.com/face-reading/mask-outline-image' \
  --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,
  "message": "success",
  "data": {
    "processed_image_url": "https://sample-image.jpg",
    "traits": {
      "confidence": {
        "score": 65,
        "note": "steady gaze suggests a quiet self assurance"
      },
      "energy": {
        "score": 40,
        "note": "relaxed posture and neutral expression show low energy"
      },
      "calmness": {
        "score": 85,
        "note": "very composed and serene facial features"
      },
      "happiness": {
        "score": 30,
        "note": "neutral mouth with no visible smile"
      },
      "approachability": {
        "score": 60,
        "note": "soft eyes make the subject seem open"
      }
    }
  }
}