Skip to content

title: Relationship Composite API Endpoint description: Developer documentation for the Relationship Composite endpoint in The Numerology API: relationship composite numerology synthesis, request parameter options, authentication, multilingual JSON responses, and production-ready examples. Extended endpoints are available only on the direct Numerology API platform (RapidAPI gateway not supported).


Relationship Composite

The Relationship Composite endpoint returns enterprise numerology output for relationship composite numerology synthesis. Use this page for integration-ready parameter rules, allowed options, and response examples.

Endpoint

Method Path
POST https://api.numerologyapi.com/api/v1/relationship-composite

Availability

  • Authentication: X-API-Key (or Authorization: Bearer YOUR_API_KEY)
  • Supported lang values: en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh
  • Access channel: direct API (https://api.numerologyapi.com)
  • RapidAPI gateway: Not currently supported for extended endpoints

Parameters

POST Query Parameters

Parameter Type Required Default Options Description
lang string No en en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh Response language (supported: en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh)

POST Body Parameters

Parameter Type Required Default Options Description
person_a object Yes — required keys: full_name, dob First person data object.
person_a.full_name string Yes — length 1..160; letters/spaces allowed; keep <= 160 chars Full name for numerology analysis.
person_a.dob string Yes — pattern ^\d{4}-\d{2}-\d{2}$ Date of birth in YYYY-MM-DD format.
person_b object Yes — required keys: full_name, dob Second person data object.
person_b.full_name string Yes — length 1..160; letters/spaces allowed; keep <= 160 chars Full name for numerology analysis.
person_b.dob string Yes — pattern ^\d{4}-\d{2}-\d{2}$ Date of birth in YYYY-MM-DD format.
num_sys string No pythagorean pythagorean, chaldean, vedic Optional numerology system. Supported values: pythagorean, chaldean, vedic. Defaults to pythagorean.

Response Example

Response Example
{
  "numerology_system": "pythagorean",
  "person_a": {
    "name": "John Doe",
    "numerology_system": "pythagorean",
    "normalized_name": "John Doe",
    "dob": "1992-07-16",
    "life_path_number": 8,
    "expression_number": 8,
    "heart_desire_number": 8,
    "personality_number": 9,
    "birth_day_number": 7,
    "hidden_passion_numbers": [
      5,
      6
    ]
  },
  "person_b": {
    "name": "John Doe",
    "numerology_system": "pythagorean",
    "normalized_name": "John Doe",
    "dob": "1992-07-16",
    "life_path_number": 8,
    "expression_number": 8,
    "heart_desire_number": 8,
    "personality_number": 9,
    "birth_day_number": 7,
    "hidden_passion_numbers": [
      5,
      6
    ]
  },
  "composite_score": 92,
  "composite_label": "Exceptional Composite",
  "composite_numbers": {
    "shared_mission_number": 5,
    "growth_challenge_number": 2,
    "emotional_tone_number": 7,
    "prosperity_number": 3,
    "communication_number": 7
  },
  "shared_mission": {
    "number": 5,
    "theme": "Grow through movement, freedom, and adaptive expansion",
    "meaning": {
      "title": "Composite Number 5: The Freedom Bond",
      "overview": "A composite 5 relationship is dynamic, changeable, exploratory, and growth-oriented through movement. This kind of connection often exists to break old patterns, awaken freedom, challenge stagnation, and expand perspective through experience. It can feel exciting, liberating, and highly alive — but it needs maturity to avoid instability.",
      "shared_mission": "The mission of this relationship is to expand, liberate, explore, and evolve through change. The bond often exists to free both people from outdated limitations.",
      "higher_expression": [
        "Adventure, aliveness, experimentation, and growth through movement",
        "Strong chemistry and stimulating relational energy",
        "A relationship that opens new doors, places, ideas, or identities",
        "Powerful potential for expansion, travel, innovation, or reinvention"
      ],
      "shadow_pattern": [
        "Instability, inconsistency, or fear of commitment",
        "Thrill-seeking without emotional grounding",
        "Escapism, impulsiveness, or repeating chaos instead of growth",
        "Confusing freedom with lack of responsibility"
      ],
      "best_for_growth": [
        "Learning how to keep freedom and commitment in the same field",
        "Grounding excitement with honesty and structure",
        "Using change as growth rather than avoiding depth",
        "Creating flexibility without eroding trust"
      ],
      "spiritual_message": "This bond teaches that freedom is not the opposite of love. It becomes sacred when both people learn to evolve without abandoning truth or responsibility.",
      "affirmation": "We grow through freedom, honesty, and conscious evolution."
    },
    "detailed_meaning": "A composite 5 relationship is built around movement, freedom, change, experimentation, and expansion through experience. Such a bond rarely exists to stay static. It often enters life as a catalyst for growth, liberation, and the breaking of outdated emotional or relational patterns. This relationship may feel exciting, unpredictable, adventurous, or full of possibility because its field is charged with transition. In higher expression, this can create a bond that expands both people’s world, increases vitality, introduces new experience, and helps each person outgrow fear, stagnation, or inherited limitations. In lower expression, however, the same energy can become unstable, chaotic, avoidant, or addicted to novelty. A composite 5 partnership may struggle when either person equates freedom with emotional inconsistency or confuses intensity with progress. The deeper purpose of the bond is not disorder but conscious evolution. Spiritually, this relationship teaches whether change can be held without betrayal, whether freedom can coexist with honesty, and whether desire for movement can mature into intentional expansion rather than restless escape. When lived well, this bond becomes a path of courageous, adaptive, truth-based growth."
  },
  "growth_challenge": {
    "number": 2,
    "theme": "over-sensitivity, passivity, or emotional dependency"
  },
  "emotional_tone": {
    "number": 7,
    "theme": "deep, private, and introspective"
  },
  "prosperity_dynamics": {
    "number": 3,
    "theme": "expands through creativity, visibility, and marketing"
  },
  "communication_pattern": {
    "number": 7,
    "theme": "selective, thoughtful, and sometimes quiet"
  },
  "dimension_scores": {
    "emotional_resonance": 90,
    "communication": 90,
    "prosperity_dynamics": 95,
    "growth_potential": 92
  },
  "strengths": [
    "Strong emotional resonance and heart-level understanding",
    "Constructive communication pattern with strong expressive potential",
    "Supportive material and prosperity dynamics when aligned",
    "The relationship strongly stimulates evolution and mutual growth"
  ],
  "watchouts": [
    "No major structural caution dominates, though conscious maintenance still matters"
  ],
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "f06f029f1f414961",
    "quota": "unlimited",
    "usage_tracking": true,
    "advanced_relationship_model": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "1.0.2",
    "endpoint_name": "relationship_composite_post",
    "endpoint_description": "Builds a composite numerology field for two people, revealing shared mission, growth challenge, emotional tone, prosperity dynamics, and communication pattern.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-08-17T17:53:27.881384+01:00",
    "data_source": "Internal Engine",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "fr",
      "es",
      "de",
      "pt",
      "ja",
      "hi",
      "ar",
      "ru",
      "tr",
      "it",
      "pl",
      "nl",
      "id",
      "ko",
      "th",
      "ro",
      "ur",
      "gu",
      "bn",
      "vi",
      "ta",
      "te",
      "mr",
      "pa",
      "zh"
    ],
    "notes": ""
  }
}

Open Dashboard


Note

This endpoint belongs to the Extended suite and is available through direct API access at https://api.numerologyapi.com. It is currently not supported via the RapidAPI gateway.