🏠 Vastu API and ✋ Palmistry API are now live. Ship them in your app today.

Compatibility Guidance

You must provide a valid compatibility_id to call this API. How to get Compatibility ID →
The Compatibility Guidance API turns the couple's palm comparison into practical relationship guidance. It uses the stored compatibility profile to identify what is already working well, where the partners can grow together, and how their differences can become complementary strengths.

The response includes strengths, growth_areas, three actionable advice items, and a closing_thought. Each point is grounded in the named palm features and relationship patterns identified for the two partners.

This is the guidance layer of the Partner Compatibility API. It converts the palmistry analysis into clear next steps that help the couple nurture communication, affection, and shared growth.
POSThttps://vision.astrologyapi.com/palmistry/compatibility-guidance

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.

Request Parameters

compatibility_idstringrequired

Compatibility ID returned by Get Compatibility ID. Use this instead of the two partner palm IDs.

curl --location 'https://vision.astrologyapi.com/palmistry/compatibility-guidance' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "compatibility_id": "c5d096cc-0ef2-4c0e-a86b-dcef63e550bc"
}'
Try it

Runs with sample data — no API key needed

{
  "status": true,
  "message": "success",
  "data": {
    "compatibility": {
      "overall": {
        "score": 84,
        "level": "Strong match"
      },
      "strengths": [
        "Your shared Air element creates a natural ease in understanding each other's thoughts and needs."
      ],
      "growth_areas": [
        "Set aside time for light-hearted activities."
      ],
      "advice": [
        "Set aside regular time for open conversations."
      ],
      "closing_thought": "Your palms show a partnership built on a rare alignment of thought, feeling, and direction."
    }
  }
}