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¶

Method	Path
`GET`	`https://the-numerology-api.p.rapidapi.com/compatibility-score`
`POST`	`https://the-numerology-api.p.rapidapi.com/compatibility-score`

Note: POST uses same path as GET — no /post suffix.

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¶

Param	Type	Required	Description
`first_name_1`	string	Yes	First name
`middle_name_1`	string	No	Middle name(s)
`last_name_1`	string	Yes	Last name
`dob_1`	string	Yes	DOB in `YYYY-MM-DD`

Person 2¶

Param	Type	Required	Description
`first_name_2`	string	Yes	First name
`middle_name_2`	string	No	Middle name(s)
`last_name_2`	string	Yes	Last name
`dob_2`	string	Yes	DOB in `YYYY-MM-DD`

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 Logic¶

Factor	Weight
Life Path	1.3
Heart's Desire	1.3
Personality	1.2
Destiny Number	1.2
Attitude Number	1.0
Hidden Passion	1.0
Subconscious Self	0.8
Balance Number	0.8
Rational Thought	0.7

Overall Score = Weighted average, rounded to 1 decimal.

Overall Insight Levels¶

Score	Insight
≥ 85	Very strong – Natural harmony
≥ 70	Strong – Great potential
≥ 50	Moderate – Growth opportunity
< 50	Low – Requires effort

View on RapidAPI

Note

9 core numbers compared.
Hidden Passion: First dominant number used.
Master Numbers: Fully preserved (11, 22, 33).
Validation:
Missing required fields → 400
Invalid date → 400
Use Case: Dating apps, matchmaking, team building, marriage counseling.
Caching: Not specified — default behavior.