Numerology Compatibility Checker — score two profiles

Check Numerology Compatibility API

What it does

Numerology Compatibility Checker scores the compatibility between two people using their full names and birth dates. Send person_a and person_b, each with a full_name and birth_date, and get back a numeric compatibility_score plus a written summary.

The response also includes strengths and cautions as arrays of strings, along with person_a_numbers and person_b_numbers objects for the underlying numerology values used in the analysis. That makes it easier to surface both the headline result and the supporting details in a relationship app, matchmaking flow, or horoscope feature.

Use it when you want a lightweight compatibility readout without building your own numerology logic. The output is structured for display, filtering, or further processing: you can show the score, explain the main positives and risks, and store the per-person number breakdown alongside the result.

Numerology Compatibility Checker is suited to consumer apps, entertainment experiences, and profile-based recommendation flows where a simple 0–100 compatibility score is enough to drive the next step.

curl -X POST "http://localhost:8080/dosvak/score-numerology-compatibility" \ -H "apy-token: $APY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "person_a": { "full_name": "Aditi Sharma", "birth_date": "1990-05-14" }, "person_b": { "full_name": "Rahul Mehta", "birth_date": "1988-11-22" } }'

{ "summary": "High compatibility with strong communication alignment.", "cautions": ["Be mindful of different pacing."], "strengths": ["Shared values", "Good emotional balance"], "person_a_numbers": {}, "person_b_numbers": {}, "compatibility_score": 82 }

About this endpoint

What it does

Scores the numerology compatibility between two people based on each person’s full name and birth date. The response returns a compatibility summary along with each person’s numerology numbers, strengths, cautions, and an overall score.

Request Body

Parameter	Type	Mandatory	Description
person_a	Object	Yes	The first person’s details. Contains `full_name` and `birth_date`.
person_a.full_name	String	Yes	The first person’s full name.
person_a.birth_date	String	Yes	The first person’s birth date in `date` format.
person_b	Object	Yes	The second person’s details. Contains `full_name` and `birth_date`.
person_b.full_name	String	Yes	The second person’s full name.
person_b.birth_date	String	Yes	The second person’s birth date in `date` format.

Response

Returns a JSON object with summary as a string, cautions and strengths as string arrays, person_a_numbers and person_b_numbers as objects with additional properties, and compatibility_score as an integer from 0 to 100.

Parameter	Type	Mandatory	Description
summary	String	No	A textual summary of the compatibility result.
cautions	String Array	No	A list of cautionary points.
strengths	String Array	No	A list of strengths in the pairing.
person_a_numbers	Object	No	Numerology numbers for person A. The object may contain additional properties.
person_b_numbers	Object	No	Numerology numbers for person B. The object may contain additional properties.
compatibility_score	Integer	No	The compatibility score, ranging from 0 to 100.

Body

Name

Type

Description

bodyREQUIRED

object

—

Check Numerology Compatibility API

What it does

QUICKSTART

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Body

Errors any endpoint can return