title: Soul Contract Reading API Endpoint description: Developer documentation for the Soul Contract Reading endpoint in The Numerology API: soul contract numerology interpretation, 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).
Soul Contract Reading¶
The Soul Contract Reading endpoint returns enterprise numerology output for soul contract numerology interpretation. Use this page for integration-ready parameter rules, allowed options, and response examples.
Endpoint¶
| Method | Path |
|---|---|
GET | https://api.numerologyapi.com/api/v1/soul-contract-reading |
POST | https://api.numerologyapi.com/api/v1/soul-contract-reading |
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¶
GET Query Parameters¶
| Parameter | Type | Required | Default | Options | Description |
|---|---|---|---|---|---|
full_name | string | Yes | — | length 1..160; letters/spaces allowed; keep <= 160 chars | Full birth name or current full name |
dob | string | Yes | — | pattern ^\d{4}-\d{2}-\d{2}$ | Date of birth in YYYY-MM-DD format |
lang | string | No | en | en, es, de, fr, pt | Response language (supported: en, es, de, fr, pt) |
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 |
|---|---|---|---|---|---|
full_name | string | Yes | — | length 1..160; letters/spaces allowed; keep <= 160 chars | Full name for numerology analysis. |
dob | string | Yes | — | pattern ^\d{4}-\d{2}-\d{2}$ | Date of birth in YYYY-MM-DD format. |
Response Example¶
GET¶
{
"full_name": "John Alan Doe",
"normalized_full_name": "John Alan Doe",
"dob": "1992-07-16",
"letters_only": "JOHNALANDOE",
"letter_breakdown": [
{
"letter": "J",
"value": 1
},
{
"letter": "O",
"value": 6
},
{
"letter": "H",
"value": 8
},
{
"letter": "N",
"value": 5
},
{
"letter": "A",
"value": 1
},
{
"letter": "L",
"value": 3
},
{
"letter": "A",
"value": 1
},
{
"letter": "N",
"value": 5
},
{
"letter": "D",
"value": 4
},
{
"letter": "O",
"value": 6
},
{
"letter": "E",
"value": 5
}
],
"core_numbers": {
"life_path_number": 8,
"expression_number": 9,
"heart_desire_number": 1,
"personality_number": 8,
"birth_day_number": 7,
"attitude_number": 5,
"maturity_number": 8,
"primary_hidden_passion": 1,
"life_path_raw_total": 35,
"expression_total": 45,
"heart_desire_total": 19,
"personality_total": 26,
"birth_day_raw": 16,
"attitude_raw": 14,
"maturity_raw": 17
},
"soul_contract_signature": [
"Karmic refinement contract",
"Leadership / manifestation contract",
"Legacy-phase contract"
],
"soul_contract_archetypes": [
"Karmic refinement contract",
"Leadership / manifestation contract",
"Legacy-phase contract",
"Builder / stewardship contract",
"Healing / service contract",
"Karmic restoration contract",
"Manifestation / command contract"
],
"soul_contract_meaning_keys": [
"karmic_refinement_contract",
"leadership_manifestation_contract",
"legacy_phase_contract",
"builder_stewardship_contract",
"healing_service_contract",
"karmic_restoration_contract",
"manifestation_command_contract",
"default"
],
"life_mission_themes": [
"Learning right use of power, wealth, and authority",
"Growing into larger influence, leadership, or building work"
],
"karmic_patterns": [
{
"type": "karmic_debt",
"number": 16,
"theme": "Humility, ego correction, and inner awakening"
},
{
"type": "karmic_lesson",
"number": 2,
"theme": "Sensitivity and cooperation"
},
{
"type": "karmic_lesson",
"number": 7,
"theme": "Faith and introspection"
},
{
"type": "karmic_lesson",
"number": 9,
"theme": "Compassion and closure"
},
{
"type": "attitude_pattern",
"number": 5,
"theme": "Early-life outer attitude strongly shapes current karmic expression"
}
],
"gift_frequencies": [
{
"theme": "Leadership Gift",
"source_number": 8
},
{
"theme": "Service / Healing Gift",
"source_number": 9
},
{
"theme": "Courage and individuality",
"source_number": 1
},
{
"theme": "Adaptability and movement",
"source_number": 5
}
],
"spiritual_lessons": [
"Use power, success, and influence in service of alignment rather than ego",
"Learn how strength can remain open-hearted and wise",
"Develop the qualities represented by your missing number lessons rather than avoiding them",
"Transform repetition into wisdom by facing karmic debts consciously and consistently"
],
"soul_agreements": [
"An agreement to lead, build, or hold responsibility in visible ways"
],
"energetic_markers": {
"hidden_passion_numbers": [
1,
5
],
"karmic_debt_numbers": [
16
],
"karmic_lesson_numbers": [
2,
7,
9
],
"master_vibrations": {}
},
"meaning": {
"soul_contract": {
"title": "Karmic Refinement Contract",
"overview": "This contract suggests that an important part of your incarnation involves correction, refinement, and completion of unfinished energetic lessons. Rather than indicating punishment, this pattern points to a soul that came in with specific distortions, habits, debts, or imbalances ready to be transformed through conscious living.",
"core_message": "Your path is strongly shaped by refinement — the soul appears to be learning through repetition until wisdom becomes embodied.",
"what_this_contract_often_means": [
"Certain lessons may repeat until they are handled with maturity and truth",
"Patterns involving discipline, ego, freedom, responsibility, or humility may carry unusual weight",
"The life may include encounters that force a more conscious way of living",
"Growth often comes less through ease and more through deep correction and re-alignment"
],
"gifts_inside_this_contract": [
"Potential for profound maturity once lessons are integrated",
"Capacity to transmute past imbalance into wisdom",
"A life that can eventually become highly grounded and spiritually honest",
"Authority born from lived refinement rather than theory"
],
"watch_out": [
"Shame or fatalism around karmic language",
"Repeating known patterns while spiritualizing them instead of changing them",
"Resisting humility when the lesson requires surrender or responsibility",
"Trying to bypass karmic work through image, belief, or performance"
],
"integration_guidance": "Treat recurring difficulty as information, not as personal condemnation. Your breakthroughs are likely hidden inside the lessons you stop running from.",
"affirmation": "I transform repetition into wisdom and meet my karmic refinement with courage and truth."
}
},
"detailed_meaning": {
"soul_contract": "This soul contract signifies an agreement to resolve specific past-life patterns, debts, or lessons in this lifetime. You are here to learn patience, humility, and resilience through repeated challenges that mirror unresolved issues. Your path involves recognizing triggers, breaking cycles of behavior, and choosing growth over comfort. However, the shadow side includes feeling victimized by circumstances or repeating mistakes without learning; you may feel burdened by 'bad luck' that is actually curriculum. To honor this contract, practice self-reflection, forgive yourself and others, and view obstacles as teachers. When aligned, you become free of ancestral burdens, proving that karma is not punishment but an opportunity for soul evolution."
},
"_enterprise": {
"client": "The Numerology API",
"plan": "Enterprise",
"request_id": "2d77726f6104e004",
"quota": "unlimited",
"usage_tracking": true,
"premium_spiritual_report": true
},
"_api_metadata_": {
"api_name": "The Numerology API by Dakidarts®",
"api_version": "1.0.0",
"endpoint_name": "soul_contract_reading",
"endpoint_description": "Reveals life mission themes, karmic patterns, gift frequencies, spiritual lessons, and soul agreements from full name and date of birth.",
"developer": "Dakidarts®",
"copyright": "© 2026 Dakidarts®. All rights reserved.",
"documentation_url": "https://docs.numerologyapi.com/",
"response_timestamp": "2026-03-28T14:38:06.617630+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": ""
}
}
¶
{
"full_name": "John Alan Doe",
"normalized_full_name": "John Alan Doe",
"dob": "1992-07-16",
"letters_only": "JOHNALANDOE",
"letter_breakdown": [
{
"letter": "J",
"value": 1
},
{
"letter": "O",
"value": 6
},
{
"letter": "H",
"value": 8
},
{
"letter": "N",
"value": 5
},
{
"letter": "A",
"value": 1
},
{
"letter": "L",
"value": 3
},
{
"letter": "A",
"value": 1
},
{
"letter": "N",
"value": 5
},
{
"letter": "D",
"value": 4
},
{
"letter": "O",
"value": 6
},
{
"letter": "E",
"value": 5
}
],
"core_numbers": {
"life_path_number": 8,
"expression_number": 9,
"heart_desire_number": 1,
"personality_number": 8,
"birth_day_number": 7,
"attitude_number": 5,
"maturity_number": 8,
"primary_hidden_passion": 1,
"life_path_raw_total": 35,
"expression_total": 45,
"heart_desire_total": 19,
"personality_total": 26,
"birth_day_raw": 16,
"attitude_raw": 14,
"maturity_raw": 17
},
"soul_contract_signature": [
"Karmic refinement contract",
"Leadership / manifestation contract",
"Legacy-phase contract"
],
"soul_contract_archetypes": [
"Karmic refinement contract",
"Leadership / manifestation contract",
"Legacy-phase contract",
"Builder / stewardship contract",
"Healing / service contract",
"Karmic restoration contract",
"Manifestation / command contract"
],
"soul_contract_meaning_keys": [
"karmic_refinement_contract",
"leadership_manifestation_contract",
"legacy_phase_contract",
"builder_stewardship_contract",
"healing_service_contract",
"karmic_restoration_contract",
"manifestation_command_contract",
"default"
],
"life_mission_themes": [
"Learning right use of power, wealth, and authority",
"Growing into larger influence, leadership, or building work"
],
"karmic_patterns": [
{
"type": "karmic_debt",
"number": 16,
"theme": "Humility, ego correction, and inner awakening"
},
{
"type": "karmic_lesson",
"number": 2,
"theme": "Sensitivity and cooperation"
},
{
"type": "karmic_lesson",
"number": 7,
"theme": "Faith and introspection"
},
{
"type": "karmic_lesson",
"number": 9,
"theme": "Compassion and closure"
},
{
"type": "attitude_pattern",
"number": 5,
"theme": "Early-life outer attitude strongly shapes current karmic expression"
}
],
"gift_frequencies": [
{
"theme": "Leadership Gift",
"source_number": 8
},
{
"theme": "Service / Healing Gift",
"source_number": 9
},
{
"theme": "Courage and individuality",
"source_number": 1
},
{
"theme": "Adaptability and movement",
"source_number": 5
}
],
"spiritual_lessons": [
"Use power, success, and influence in service of alignment rather than ego",
"Learn how strength can remain open-hearted and wise",
"Develop the qualities represented by your missing number lessons rather than avoiding them",
"Transform repetition into wisdom by facing karmic debts consciously and consistently"
],
"soul_agreements": [
"An agreement to lead, build, or hold responsibility in visible ways"
],
"energetic_markers": {
"hidden_passion_numbers": [
1,
5
],
"karmic_debt_numbers": [
16
],
"karmic_lesson_numbers": [
2,
7,
9
],
"master_vibrations": {}
},
"meaning": {
"soul_contract": {
"title": "Karmic Refinement Contract",
"overview": "This contract suggests that an important part of your incarnation involves correction, refinement, and completion of unfinished energetic lessons. Rather than indicating punishment, this pattern points to a soul that came in with specific distortions, habits, debts, or imbalances ready to be transformed through conscious living.",
"core_message": "Your path is strongly shaped by refinement — the soul appears to be learning through repetition until wisdom becomes embodied.",
"what_this_contract_often_means": [
"Certain lessons may repeat until they are handled with maturity and truth",
"Patterns involving discipline, ego, freedom, responsibility, or humility may carry unusual weight",
"The life may include encounters that force a more conscious way of living",
"Growth often comes less through ease and more through deep correction and re-alignment"
],
"gifts_inside_this_contract": [
"Potential for profound maturity once lessons are integrated",
"Capacity to transmute past imbalance into wisdom",
"A life that can eventually become highly grounded and spiritually honest",
"Authority born from lived refinement rather than theory"
],
"watch_out": [
"Shame or fatalism around karmic language",
"Repeating known patterns while spiritualizing them instead of changing them",
"Resisting humility when the lesson requires surrender or responsibility",
"Trying to bypass karmic work through image, belief, or performance"
],
"integration_guidance": "Treat recurring difficulty as information, not as personal condemnation. Your breakthroughs are likely hidden inside the lessons you stop running from.",
"affirmation": "I transform repetition into wisdom and meet my karmic refinement with courage and truth."
}
},
"detailed_meaning": {
"soul_contract": "This soul contract signifies an agreement to resolve specific past-life patterns, debts, or lessons in this lifetime. You are here to learn patience, humility, and resilience through repeated challenges that mirror unresolved issues. Your path involves recognizing triggers, breaking cycles of behavior, and choosing growth over comfort. However, the shadow side includes feeling victimized by circumstances or repeating mistakes without learning; you may feel burdened by 'bad luck' that is actually curriculum. To honor this contract, practice self-reflection, forgive yourself and others, and view obstacles as teachers. When aligned, you become free of ancestral burdens, proving that karma is not punishment but an opportunity for soul evolution."
},
"_enterprise": {
"client": "The Numerology API",
"plan": "Enterprise",
"request_id": "2d77726f6104e004",
"quota": "unlimited",
"usage_tracking": true,
"premium_spiritual_report": true
},
"_api_metadata_": {
"api_name": "The Numerology API by Dakidarts®",
"api_version": "1.0.0",
"endpoint_name": "soul_contract_reading",
"endpoint_description": "Reveals life mission themes, karmic patterns, gift frequencies, spiritual lessons, and soul agreements from full name and date of birth.",
"developer": "Dakidarts®",
"copyright": "© 2026 Dakidarts®. All rights reserved.",
"documentation_url": "https://docs.numerologyapi.com/",
"response_timestamp": "2026-03-28T14:38:06.617630+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.