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

Mask Outline Image

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/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

Generate the processed mask outline image for a stored face reading.
← 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"
      }
    }
  }
}