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(orAuthorization: Bearer YOUR_API_KEY) - Supported
langvalues: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": ""
}
}
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.