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

Marriage Reading

You must provide a valid face_id to call this API. How to get Face ID →
Marriage Reading API focuses on long-term partnership, commitment style, relationship stability, and patterns connected with married or committed life. It uses the same stored facial observations that support the love and family readings, but the interpretation is centred specifically on partnership and commitment.

The response provides a dedicated marriage-oriented interpretation instead of mixing it into the wider Love Reading. This separation makes it easier to present romance and long-term partnership as two distinct sections in the application.
POSThttps://vision.astrologyapi.com/face-reading/marriage

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 marriage category reading for a previously scanned face.
curl --location 'https://vision.astrologyapi.com/face-reading/marriage' \
  --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": {
    "partnership_nature": "The balanced jaw and rounded chin suggest a supportive and grounding presence in a partnership, characterized by a natural inclination toward stability and emotional maturity.",
    "spouse_palace_reading": "The smooth and full outer corner area of the Spouse Palace indicates a strong tendency toward marital harmony and a relationship marked by mutual ease and emotional satisfaction.",
    "ideal_partner_qualities": [
      "Emotionally stable",
      "Communicative",
      "Nurturing"
    ],
    "harmony_and_friction": "Strengths lie in the symmetrical mouth and calm eyes, suggesting a capacity for balanced communication and observant empathy; friction is minimal, though a tendency toward neutrality in expression may occasionally mask deep-seated needs.",
    "commitment_indication": "A moderate and medium-length philtrum suggests a steady approach to commitment and a healthy, balanced connection to family traditions and lineage.",
    "timing_tendency": "With a balanced lower court and rounded chin, there is a tendency for partnerships to stabilize and flourish deeply in the mid-to-later stages of life.",
    "summary": "The facial features point toward a harmonious and stable romantic life, supported by strong communication and emotional balance. The smoothness of the Spouse Palace combined with a supportive chin suggests a partnership that grows in strength and loyalty over time."
  }
}