Compatibiliteitsscore¶
De Compatibiliteitsscore analyseert 9 kernnumerologiegetallen van twee personen (Levenspad, Hartwens Verlangen, Persoonlijkheid, enz.) en geeft de volgende informatie terug:
- Individuele numerologieprofielen
- Compatibiliteitsscores per paar
- Gewichtte algehele score (0–100)
- Inzicht in de relatie
Geschikt voor dating, huwelijk, zakelijke of vriendschappelijke analyse. Meestergetallen: Volledig ondersteund (11, 22, 33).
Endpoint¶
| Methode | Pad |
|---|---|
GET | https://api.numerologyapi.com/api/v1/compatibility-score |
POST | https://api.numerologyapi.com/api/v1/compatibility-score |
Notitie
POST uses same path as GET — no /post suffix.
Vereiste Headers¶
X-API-Key: YOUR_API_KEYHost: api.numerologyapi.comContent-Type: application/json(Alleen POST)
Maak en beheer API-sleutels in het Numerology API dashboard.
Parameters¶
Persoon 1¶
| Parameter | Type | Vereist | Beschrijving |
|---|---|---|---|
first_name_1 | string | Ja | Voornaam |
middle_name_1 | string | Nee | Achternaam(en) |
last_name_1 | string | Ja | Laatste naam |
dob_1 | string | Ja | Geboortedatum in YYYY-MM-DD |
num_sys | string | Nee | Optioneel numerologie systeem. Ondersteunde waarden: pythagorean, chaldean, vedic. Standaardwaarde is pythagorean. |
Persoon 2¶
| Parameter | Type | Vereist | Beschrijving |
|---|---|---|---|
first_name_2 | string | Ja | Voornaam |
middle_name_2 | string | Nee | Achternaam(en) |
last_name_2 | string | Ja | Achternaam |
dob_2 | string | Ja | Geboortedatum in YYYY-MM-DD |
| language | string | Ja | Taalcode voor de reactie. Ondersteunde waarden zijn onder andere en, es, de, fr, pt, enz. | | lang | string | Ja | Alias voor language. Gebruik ofwel language of lang. |
Voeg het optionele query-parameter
langtoe om de reacties te lokaliseren. Ondersteunde waarden:en,es,de,fr,pt.
Voorbeeldverzoeken¶
GET Verzoek¶
curl --request GET \
--url "https://api.numerologyapi.com/api/v1/compatibility-score?first_name_1=John&last_name_1=Doe&first_name_2=John&last_name_2=Doe&dob_1=1992-07-16&dob_2=1992-07-16&middle_name_1=&middle_name_2=&lang=en&num_sys=pythagorean" \
--header "X-API-Key: YOUR_API_KEY"
POST Verzoek (JSON-body)¶
curl --request POST \
--url "https://api.numerologyapi.com/api/v1/compatibility-score?lang=en" \
--header "X-API-Key: YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"first_name_1": "John",
"last_name_1": "Doe",
"first_name_2": "John",
"last_name_2": "Doe",
"dob_1": "1992-07-16",
"dob_2": "1992-07-16",
"middle_name_1": "",
"middle_name_2": "",
"num_sys": "pythagorean"
}'
Voorbeeldreactie¶
{
"numerology_system": "pythagorean",
"person_1": {
"full_name": "John Doe",
"initials": "JD",
"dob": "1992-07-16",
"life_path": 8,
"heart_desire": 8,
"personality": 9,
"hidden_passion": [
5,
6
],
"destiny_number": 8,
"attitude_number": 5,
"subconscious_self_number": 5,
"balance_number": 5,
"rational_thought_number": 9
},
"person_2": {
"full_name": "John Doe",
"initials": "JD",
"dob": "1992-07-16",
"life_path": 8,
"heart_desire": 8,
"personality": 9,
"hidden_passion": [
5,
6
],
"destiny_number": 8,
"attitude_number": 5,
"subconscious_self_number": 5,
"balance_number": 5,
"rational_thought_number": 9
},
"compatibility_scores": {
"life_path_score": 80,
"heart_desire_score": 80,
"personality_score": 85,
"hidden_passion_score": 95,
"destiny_number_score": 80,
"attitude_number_score": 95,
"subconscious_self_score": 95,
"balance_number_score": 95,
"rational_thought_score": 85,
"overall_score": 86.8,
"overall_insight": "Very strong & harmonious connection. Your energies flow together with grace and mutual support. This is a relationship that feels like 'coming home' — powerful synergy with only gentle adjustments needed."
},
"_enterprise": {
"client": "The Numerology API",
"plan": "Enterprise",
"request_id": "ced3a432226491dc",
"quota": "unlimited",
"usage_tracking": true
},
"_api_metadata_": {
"api_name": "The Numerology API by Dakidarts®",
"api_version": "0.1.1",
"endpoint_name": "compatibility_score",
"endpoint_description": "Computes numerology compatibility score between two individuals.",
"developer": "Dakidarts®",
"copyright": "© 2026 Dakidarts®. All rights reserved.",
"documentation_url": "https://docs.numerologyapi.com/",
"response_timestamp": "2026-02-28T07:36:26.749083+01:00",
"data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
"cacheable_status": true,
"report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
"response_language": "en",
"supported_languages": [
"en",
"es",
"de",
"fr",
"pt"
],
"notes": ""
}
}
Scoring Algoritme¶
Het algoritme voor het beoordelen van compatibiliteit gebruikt een meerlagige aanpak die numerologische wijsheid combineert met wiskundige precisie:
-
Mapping naar de Root Number: Alle getallen (inclusief Master Numbers 11, 22, 33) worden gemapt naar hun wortelvibraties (bijvoorbeeld 11→2, 22→4, 33→6). De berekeningen gebruiken deze root-waarden voor de beoordeling van de compatibiliteit.2. Definities van Numerologische Combinaties: Specifieke getalcombinaties die bekend staan om een sterke compatibiliteit in de numerologie, krijgen vooraf bepaalde basisscores toegewezen. Bijvoorbeeld:
(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)
-
Fallback Berekening: Als een combinatie niet expliciet is gedefinieerd, wordt een standaardformule gebruikt:
base_score = max(25, 100 - root_diff * 10), die een minimale basiscompatibiliteit van 25% garandeert. -
Bonus voor Resonantie met Master Numbers: Combinaties met Master Numbers ontvangen extra punten als hun wortelwaarden identiek zijn (+15) of direct naast elkaar liggen (+8), wat hun versterkte spirituele energie weerspiegelt.
-
Bonus voor Exacte Match: Wanneer beide oorspronkelijke getallen (voor vermindering van de wortel) identiek zijn, wordt een extra bonus van +10 toegepast, die de resonantie van gedeelde vibratie erkent.
-
Eindberekening: De totale score is de som van de basisscore, masterbonus en exacte match-bonus, met een maximum van 100%.
Gewichtingsfactoren¶
| Factor | Gewicht |
|---|---|
| Life Path (Levenspad) | 1.4 |
| Heart's Desire (Wensen) | 1.35 |
| Destiny Number (Lotnummer) | 1.25 |
| Personality (Persoonlijkheid) | 1.15 |
| Hidden Passion (Verborgen Passie) | 1.05 |
| Attitude Number (Attitudenummer) | 1.0 |
| Subconscious Self (Onderbewustzijn) | 0.85 |
| Balance Number (Evenwichtsnummer) | 0.8 |
| Rational Thought (Rationale Denkrichting) | 0.7 |
| 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¶
| Score | Insight |
|---|---|
| ≥ 90 | Exceptional soul-level compatibility |
| ≥ 80 | Very strong & harmonious connection |
| ≥ 70 | Strong & soul-aligned compatibility |
| ≥ 60 | Solid & promising foundation |
| ≥ 50 | Moderate & balanced potential |
| ≥ 40 | Challenging yet teachable dynamic |
| ≥ 25 | Low natural harmony |
| < 25 | Very challenging alignment |
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.