Compatibility Score¶

The Compatibility Score analyzes 9 core numerology numbers from two individuals (Life Path, Heart's Desire, Personality, etc.) and returns:

• Individual numerology profiles
• Pairwise compatibility scores
• Weighted overall score (0–100)
• Relationship insight

Perfect for dating, marriage, business, or friendship analysis. Master Numbers: Fully supported (11, 22, 33).

Endpoint¶

Required Headers¶

• x-rapidapi-key: YOUR_RAPIDAPI_KEY
• x-rapidapi-host: the-numerology-api.p.rapidapi.com
• Content-Type: application/json (POST only)

Get your key from RapidAPI.

Parameters¶

Person 1¶

Person 2¶

Example Requests¶

GET Request¶

curl --request GET \
  --url "https://the-numerology-api.p.rapidapi.com/compatibility-score?first_name_1=John&middle_name_1=Edward&last_name_1=Doe&dob_1=1997-08-17&first_name_2=Jane&middle_name_2=Anne&last_name_2=Smith&dob_2=2000-02-22" \
  --header "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  --header "x-rapidapi-host: the-numerology-api.p.rapidapi.com"

POST Request (JSON Body)¶

curl --request POST \
  --url "https://the-numerology-api.p.rapidapi.com/compatibility-score" \
  --header "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  --header "x-rapidapi-host: the-numerology-api.p.rapidapi.com" \
  --header "Content-Type: application/json" \
  --data '{
     "first_name_1": "Emma",
     "middle_name_1": "Grace",
     "last_name_1": "Brown",
     "dob_1": "1990-05-15",
     "first_name_2": "Liam",
     "middle_name_2": "",
     "last_name_2": "Davis",
     "dob_2": "1988-11-22"
  }'

Response Example¶

{
   "person_1": {
     "full_name": "John Edward Doe",
     "initials": "JED",
     "dob": "1997-08-17",
     "life_path": 6,
     "heart_desire": 5,
     "personality": 4,
     "hidden_passion": [5],
     "destiny_number": 9,
     "attitude_number": 7,
     "subconscious_self_number": 6,
     "balance_number": 1,
     "rational_thought_number": 1
  },
   "person_2": {
     "full_name": "Jane Anne Smith",
     "initials": "JAS",
     "dob": "2000-02-22",
     "life_path": 8,
     "heart_desire": 3,
     "personality": 4,
     "hidden_passion": [5],
     "destiny_number": 7,
     "attitude_number": 6,
     "subconscious_self_number": 6,
     "balance_number": 3,
     "rational_thought_number": 7
  },
   "compatibility_scores": {
     "life_path_score": 78,
     "heart_desire_score": 78,
     "personality_score": 100,
     "hidden_passion_score": 100,
     "destiny_number_score": 78,
     "attitude_number_score": 89,
     "subconscious_self_score": 100,
     "balance_number_score": 78,
     "rational_thought_score": 34,
     "overall_score": 83.0,
     "overall_insight": "Strong compatibility. Many harmonious aspects, though some effort may be needed."
  },
   "status": 200
}

Scoring Algorithm¶

The compatibility scoring algorithm uses a multi-layered approach that combines numerological wisdom with mathematical precision:

1. Root Number Mapping: All numbers (including Master Numbers 11, 22, 33) are mapped to their root vibrations (e.g., 11→2, 22→4, 33→6). Calculations use these root values for compatibility assessment.

2. Numerological Pair Definitions: Specific number pairs known for strong compatibility in numerology are assigned predetermined base scores. For example:

   • (1, 5) and (5, 1): 85 (Adventure-driven combination)
   • (1, 9) and (9, 1): 75 (Leadership meets humanitarianism)
   • (2, 6) and (6, 2): 90 (Nurturing partnership)

3. Fallback Calculation: If a pair is not explicitly defined, a standard formula is used: base_score = max(25, 100 - root_diff * 10), ensuring a minimum baseline compatibility of 25%.

4. Master Number Resonance Bonus: Pairs involving Master Numbers receive additional points if their root values are identical (+15) or adjacent (+8), reflecting their intensified spiritual energy.

5. Exact Match Bonus: When both original numbers (before root reduction) are identical, an extra +10 bonus is applied, acknowledging the resonance of shared vibration.

6. Final Calculation: The total score is the sum of the base score, master bonus, and exact match bonus, capped at 100%.

Scoring Weights¶

Overall Score = Weighted average of individual scores + Intensity Factor. Intensity Factor: A small boost (up to +5%) is applied if either person's Life Path or Heart's Desire is a Master Number, reflecting their potential for deeper spiritual connection.

Overall Insight Levels¶

View on RapidAPI