Ga naar inhoud

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_KEY
  • Host: api.numerologyapi.com
  • Content-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 lang toe 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:

  1. 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)
  2. 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.

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

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

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

Open Dashboard

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.