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

Facial Hair

You must provide a valid face_id to call this API. How to get Face ID →
Facial Hair API returns observations about visible beard, moustache, stubble, or other facial-hair presentation detected in the scan. It can describe both the facial-hair `type` and its `grooming`.

For example, a response can classify the facial hair as `stubble` and describe the grooming as `even`. This information is stored as a visible feature and can be considered together with the underlying facial structure.

The API keeps grooming-related observations separate from permanent structural features such as the chin, jaw, nose, and face shape.
POSThttps://vision.astrologyapi.com/face-reading/facial-hair

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 facial hair details for a stored face reading.
← Previous
Proportions
Next →
Face Outline
curl --location 'https://vision.astrologyapi.com/face-reading/facial-hair' \
  --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": {
    "type": "stubble",
    "grooming": "even"
  }
}