🏠 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.

Prefer a compatibility ID. Use two distinct palm IDs only when a compatibility ID is unavailable.
← Previous
Compatibility Life
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": 85,
        "level": "Exceptional match"
      },
      "strengths": [
        "Your shared Air element and straight head lines make communication clear and direct, reducing misunderstandings.",
        "Both of your curved heart lines create a warm, open emotional connection where feelings are shared freely.",
        "Your matching life lines and medium elasticity mean you move through life at a similar pace, making daily life easy.",
        "Your clear marriage lines show a shared, steady intent toward commitment, building a secure and stable bond."
      ],
      "growth_areas": [
        "Because you are both Air, you may sometimes overthink or need too much space; check in with each other to ensure you are not drifting apart mentally.",
        "Your normal Venus mounts suggest a steady but not intense physical affection; make an effort to keep the physical side of your relationship warm and connected.",
        "Your shallow marriage lines indicate that your commitment is based on steady choice rather than intense passion; keep nurturing the emotional depth of your bond to prevent it from feeling routine."
      ],
      "advice": [
        "Schedule regular time for deep, open conversations to keep your mental connection strong and prevent overthinking from creating distance.",
        "Make a point to show physical affection in small, consistent ways to keep the warmth of your relationship alive, since your Venus mounts are normal rather than prominent.",
        "Discuss your long-term goals and life direction regularly to ensure your shared fate lines continue to point in the same direction."
      ],
      "closing_thought": "You two have a rare combination of shared understanding, clear communication, and steady energy. By keeping your emotional connection open and your communication direct, you will build a relationship that is both intellectually fulfilling and emotionally secure."
    }
  }
}