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

← 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": 84,
        "level": "Strong match",
        "headline": "A natural partnership built on shared clarity and steady growth"
      },
      "element_match": {
        "partner_1_element": "Air",
        "partner_2_element": "Air",
        "match_type": "harmonious"
      },
      "dimensions": {
        "element_harmony": {
          "title": "Element harmony",
          "score": 85,
          "level": "Exceptional match"
        }
      }
    }
  }
}