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,es,de,fr,pt - 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, es, de, fr, pt | Response language (supported: en, es, de, fr, pt) |
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. |
Response Example¶
POST¶
{
"person_a": {
"name": "John Alan Doe",
"normalized_name": "John Alan Doe",
"dob": "1992-07-16",
"life_path_number": 8,
"expression_number": 9,
"heart_desire_number": 1,
"personality_number": 8,
"birth_day_number": 7,
"hidden_passion_numbers": [
1,
5
]
},
"person_b": {
"name": "John Alan Doe",
"normalized_name": "John Alan Doe",
"dob": "1992-07-16",
"life_path_number": 8,
"expression_number": 9,
"heart_desire_number": 1,
"personality_number": 8,
"birth_day_number": 7,
"hidden_passion_numbers": [
1,
5
]
},
"composite_score": 90,
"composite_label": "Exceptional Composite",
"composite_numbers": {
"shared_mission_number": 7,
"growth_challenge_number": 2,
"emotional_tone_number": 2,
"prosperity_number": 5,
"communication_number": 5
},
"shared_mission": {
"number": 7,
"theme": "Seek truth, depth, and spiritual refinement together",
"meaning": {
"title": "Composite Number 7: The Sacred Inquiry Bond",
"overview": "A composite 7 relationship tends to be deep, introspective, thoughtful, spiritually charged, and sometimes emotionally private. This kind of bond often exists to awaken truth, insight, introspection, healing, and deeper questions in both people. It may feel unusual, subtle, or difficult to explain to outsiders.",
"shared_mission": "The mission of this relationship is to deepen consciousness, refine understanding, and reveal truth through inner work, patience, and spiritual or intellectual growth.",
"higher_expression": [
"Deep reflection, insight, and spiritual or philosophical intimacy",
"A relationship that matures through truth and inward depth",
"Potential for healing through honesty, contemplation, and shared seeking",
"A bond that often feels meaningful beyond surface compatibility"
],
"shadow_pattern": [
"Emotional distance, silence, withdrawal, or over-analysis",
"Difficulty sustaining warmth if the bond becomes too inward or cerebral",
"Loneliness inside the relationship if intimacy is not actively nourished",
"Using detachment as wisdom when it is really avoidance"
],
"best_for_growth": [
"Creating emotional connection alongside spiritual or intellectual depth",
"Learning to speak honestly without retreating into silence",
"Honoring the need for space without abandoning intimacy",
"Using the relationship as a place of truth, not just protection"
],
"spiritual_message": "This bond teaches that intimacy can be a path of revelation. It asks both people to discover whether truth can deepen love rather than threaten it.",
"affirmation": "We deepen through truth, wisdom, and conscious intimacy."
},
"detailed_meaning": "A composite 7 relationship is often deeply meaningful, introspective, spiritually charged, and inwardly transformative. This bond may feel less obvious to the outer world than other composites because much of its significance exists beneath the surface. The connection frequently carries themes of truth-seeking, contemplation, spiritual inquiry, emotional privacy, subtle trust, and the stripping away of illusion. In some cases, a composite 7 relationship feels almost fated not because it is dramatic, but because it quietly changes both people at the level of consciousness. The bond may repeatedly force deeper honesty, greater introspection, and a more serious relationship to inner life. In higher expression, this creates profound trust, soulful understanding, philosophical depth, and the ability to meet one another beyond superficial roles. In lower expression, the same energy can become distant, secretive, over-analytical, or emotionally undernourished. Silence may replace intimacy, or spiritual/intellectual depth may become a defense against vulnerability. Spiritually, this bond asks whether both people can love each other in truth rather than in projection. It teaches that intimacy can be contemplative, that silence can be meaningful when clean, and that love does not always arrive as emotional volume — sometimes it arrives as revelation, patience, and shared inner depth."
},
"growth_challenge": {
"number": 2,
"theme": "over-sensitivity, passivity, or emotional dependency"
},
"emotional_tone": {
"number": 2,
"theme": "gentle, sensitive, and partnership-seeking"
},
"prosperity_dynamics": {
"number": 5,
"theme": "moves through adaptability, networking, and momentum"
},
"communication_pattern": {
"number": 5,
"theme": "fast, adaptive, spontaneous, and shifting"
},
"dimension_scores": {
"emotional_resonance": 90,
"communication": 90,
"prosperity_dynamics": 90,
"growth_potential": 90
},
"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": "19d2ca4aced59a15",
"quota": "unlimited",
"usage_tracking": true,
"advanced_relationship_model": true
},
"_api_metadata_": {
"api_name": "The Numerology API by Dakidarts®",
"api_version": "1.0.0",
"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-03-28T14:37:59.530101+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": ""
}
}
¶
{
"person_a": {
"name": "John Alan Doe",
"normalized_name": "John Alan Doe",
"dob": "1992-07-16",
"life_path_number": 8,
"expression_number": 9,
"heart_desire_number": 1,
"personality_number": 8,
"birth_day_number": 7,
"hidden_passion_numbers": [
1,
5
]
},
"person_b": {
"name": "John Alan Doe",
"normalized_name": "John Alan Doe",
"dob": "1992-07-16",
"life_path_number": 8,
"expression_number": 9,
"heart_desire_number": 1,
"personality_number": 8,
"birth_day_number": 7,
"hidden_passion_numbers": [
1,
5
]
},
"composite_score": 90,
"composite_label": "Exceptional Composite",
"composite_numbers": {
"shared_mission_number": 7,
"growth_challenge_number": 2,
"emotional_tone_number": 2,
"prosperity_number": 5,
"communication_number": 5
},
"shared_mission": {
"number": 7,
"theme": "Seek truth, depth, and spiritual refinement together",
"meaning": {
"title": "Composite Number 7: The Sacred Inquiry Bond",
"overview": "A composite 7 relationship tends to be deep, introspective, thoughtful, spiritually charged, and sometimes emotionally private. This kind of bond often exists to awaken truth, insight, introspection, healing, and deeper questions in both people. It may feel unusual, subtle, or difficult to explain to outsiders.",
"shared_mission": "The mission of this relationship is to deepen consciousness, refine understanding, and reveal truth through inner work, patience, and spiritual or intellectual growth.",
"higher_expression": [
"Deep reflection, insight, and spiritual or philosophical intimacy",
"A relationship that matures through truth and inward depth",
"Potential for healing through honesty, contemplation, and shared seeking",
"A bond that often feels meaningful beyond surface compatibility"
],
"shadow_pattern": [
"Emotional distance, silence, withdrawal, or over-analysis",
"Difficulty sustaining warmth if the bond becomes too inward or cerebral",
"Loneliness inside the relationship if intimacy is not actively nourished",
"Using detachment as wisdom when it is really avoidance"
],
"best_for_growth": [
"Creating emotional connection alongside spiritual or intellectual depth",
"Learning to speak honestly without retreating into silence",
"Honoring the need for space without abandoning intimacy",
"Using the relationship as a place of truth, not just protection"
],
"spiritual_message": "This bond teaches that intimacy can be a path of revelation. It asks both people to discover whether truth can deepen love rather than threaten it.",
"affirmation": "We deepen through truth, wisdom, and conscious intimacy."
},
"detailed_meaning": "A composite 7 relationship is often deeply meaningful, introspective, spiritually charged, and inwardly transformative. This bond may feel less obvious to the outer world than other composites because much of its significance exists beneath the surface. The connection frequently carries themes of truth-seeking, contemplation, spiritual inquiry, emotional privacy, subtle trust, and the stripping away of illusion. In some cases, a composite 7 relationship feels almost fated not because it is dramatic, but because it quietly changes both people at the level of consciousness. The bond may repeatedly force deeper honesty, greater introspection, and a more serious relationship to inner life. In higher expression, this creates profound trust, soulful understanding, philosophical depth, and the ability to meet one another beyond superficial roles. In lower expression, the same energy can become distant, secretive, over-analytical, or emotionally undernourished. Silence may replace intimacy, or spiritual/intellectual depth may become a defense against vulnerability. Spiritually, this bond asks whether both people can love each other in truth rather than in projection. It teaches that intimacy can be contemplative, that silence can be meaningful when clean, and that love does not always arrive as emotional volume — sometimes it arrives as revelation, patience, and shared inner depth."
},
"growth_challenge": {
"number": 2,
"theme": "over-sensitivity, passivity, or emotional dependency"
},
"emotional_tone": {
"number": 2,
"theme": "gentle, sensitive, and partnership-seeking"
},
"prosperity_dynamics": {
"number": 5,
"theme": "moves through adaptability, networking, and momentum"
},
"communication_pattern": {
"number": 5,
"theme": "fast, adaptive, spontaneous, and shifting"
},
"dimension_scores": {
"emotional_resonance": 90,
"communication": 90,
"prosperity_dynamics": 90,
"growth_potential": 90
},
"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": "19d2ca4aced59a15",
"quota": "unlimited",
"usage_tracking": true,
"advanced_relationship_model": true
},
"_api_metadata_": {
"api_name": "The Numerology API by Dakidarts®",
"api_version": "1.0.0",
"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-03-28T14:37:59.530101+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": ""
}
}
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.