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

Compatibility Connection

You must provide a valid compatibility_id to call this API. How to get Compatibility ID →
The Compatibility Connection API creates a detailed reading of how two partners connect emotionally, mentally, and romantically. It compares the stored hand elements, Heart Lines, Head Lines, and key mounts of both partners to build one clear relationship overview.

The response includes an overall compatibility score, match level, relationship headline, and summary. It also includes element_harmony, emotional_connection, communication, and romance_attraction, with the palm features used for each interpretation.

This is the connection-focused layer of the Partner Compatibility API. It turns the two stored palm profiles into a practical explanation of how the couple communicates, expresses affection, and relates day to day.
POSThttps://vision.astrologyapi.com/palmistry/compatibility-connection

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
Get Compatibility ID
Next →
Compatibility Life
curl --location 'https://vision.astrologyapi.com/palmistry/compatibility-connection' \
  --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",
        "headline": "A natural fit built on shared clarity and steady energy",
        "summary": "You two share the same Air element, which means you understand each other's need for mental connection and open conversation. Both of you have curved heart lines and straight head lines, creating a bond that is both emotionally warm and logically grounded. Your matching life lines and medium hand elasticity suggest you move through life at a similar pace, making daily life feel easy and predictable. This is a relationship where you do not have to translate your feelings or your thoughts to be understood."
      },
      "element_match": {
        "partner_1_element": "Air",
        "partner_2_element": "Air",
        "match_type": "harmonious"
      },
      "dimensions": {
        "element_harmony": {
          "title": "Element harmony",
          "score": 85,
          "level": "Exceptional match",
          "headline": "Natural understanding and shared pace",
          "reading": "Both partners have an Air element hand, which means you both value ideas, conversation, and intellectual connection. This shared element creates a natural harmony where you understand each other's need for mental stimulation without having to explain it. Because you are both Air, you may sometimes amplify the same habits, such as overthinking or needing too much space, but your overall understanding of each other is strong.",
          "partner_1_basis": "element Air, palm rectangular",
          "partner_2_basis": "element Air, palm rectangular"
        },
        "emotional_connection": {
          "title": "Emotional connection",
          "score": 93,
          "level": "Exceptional match",
          "headline": "Warm, open, and deeply loyal feelings",
          "reading": "Partner 1 has a deep, clear, curved heart line, while Partner 2 has a clear, curved heart line. Both of you show love in an open and expressive way, which makes emotional connection feel easy and natural. The depth in Partner 1's line suggests a particularly loyal and deep emotional capacity, while Partner 2's clear line shows a steady and reliable affection. Together, you create a safe space where feelings are shared freely and trusted deeply.",
          "partner_1_basis": "heart line curved, depth deep, starts under the little finger",
          "partner_2_basis": "heart line curved, depth clear, starts under the Mercury finger"
        },
        "communication": {
          "title": "Communication & understanding",
          "score": 82,
          "level": "Strong match",
          "headline": "Clear, logical, and direct dialogue",
          "reading": "Both partners have straight, deep head lines that extend almost to the edge of the palm. This means you both think in a logical, practical, and direct way. You do not need to guess what the other is thinking because your communication style is clear and to the point. This shared approach to problem-solving makes it easy to talk through issues and find practical solutions together.",
          "partner_1_basis": "head line straight, depth deep, Mercury mount normal",
          "partner_2_basis": "head line straight, depth clear, Mercury mount normal"
        },
        "romance_attraction": {
          "title": "Romance & attraction",
          "score": 75,
          "level": "Strong match",
          "headline": "Steady affection and shared warmth",
          "reading": "Both partners have normal Venus mounts, which indicates a balanced and steady approach to physical affection and romance. You do not have the intense, fiery passion of a prominent Venus, but your affection is consistent and reliable. Your normal Luna mounts suggest that while you are not overly dreamy, you still appreciate imagination and shared experiences. Your attraction is built on a foundation of comfort and mutual respect rather than dramatic intensity.",
          "partner_1_basis": "Venus mount normal, Luna mount normal",
          "partner_2_basis": "Venus mount normal, Luna mount normal"
        }
      }
    }
  }
}