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

Family Reading

You must provide a valid face_id to call this API. How to get Face ID →
Family Reading API interprets the stored facial features in relation to home, relatives, elders, children, siblings, and the person's general orientation toward family life.

The response can include areas such as `family_orientation`, `roots_and_elders`, `children_palace_reading`, `siblings_and_close_circle`, `home_environment`, and a final `summary`. Traditional Palace concepts and facial regions are brought together to describe different parts of family life.
POSThttps://vision.astrologyapi.com/face-reading/family

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

Get a family category reading for a previously scanned face.
← Previous
Challenges Reading
Next →
Health Reading
curl --location 'https://vision.astrologyapi.com/face-reading/family' \
  --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": {
    "family_orientation": "The balanced jaw and rounded chin suggest a stable, grounded approach to family life, with a moderate and steady commitment to domestic harmony.",
    "roots_and_elders": "Information regarding the Parents Palace is limited, suggesting a neutral or independent relationship with ancestral roots.",
    "children_palace_reading": "The smooth under-eye area indicates a calm and harmonious energy toward younger generations, suggesting a lack of friction and a peaceful bond with children.",
    "siblings_and_close_circle": "Medium, straight, and neat-flowing eyebrows point toward balanced, reliable, and orderly relationships with siblings and close peers.",
    "home_environment": "With symmetrical cheeks and a balanced support palace, they likely cultivate a home environment characterized by stability, fairness, and emotional equilibrium.",
    "summary": "The individual possesses a balanced facial structure that suggests a stable and harmonious domestic life. They are likely to maintain orderly relationships with peers and a peaceful connection with the younger generation."
  }
}