Skip to content

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 (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

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, 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)
num_sys string No pythagorean pythagorean, chaldean, vedic Optional numerology system. Supported values: pythagorean, chaldean, vedic. Defaults to pythagorean.

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
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.
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",
  "full_name": "John Doe",
  "normalized_full_name": "John Doe",
  "dob": "1992-07-16",
  "letters_only": "JOHNDOE",
  "letter_breakdown": [
    {
      "letter": "J",
      "value": 1
    },
    {
      "letter": "O",
      "value": 6
    },
    {
      "letter": "H",
      "value": 8
    },
    {
      "letter": "N",
      "value": 5
    },
    {
      "letter": "D",
      "value": 4
    },
    {
      "letter": "O",
      "value": 6
    },
    {
      "letter": "E",
      "value": 5
    }
  ],
  "core_numbers": {
    "life_path_number": 8,
    "expression_number": 8,
    "heart_desire_number": 8,
    "personality_number": 9,
    "birth_day_number": 7,
    "attitude_number": 5,
    "maturity_number": 7,
    "primary_hidden_passion": 5,
    "life_path_raw_total": 35,
    "expression_total": 35,
    "heart_desire_total": 17,
    "personality_total": 18,
    "birth_day_raw": 16,
    "attitude_raw": 14,
    "maturity_raw": 16
  },
  "soul_contract_signature": [
    "Karmic refinement contract",
    "Leadership / manifestation contract"
  ],
  "soul_contract_archetypes": [
    "Karmic refinement contract",
    "Leadership / manifestation contract",
    "Creative transmission contract",
    "Builder / stewardship contract",
    "Karmic restoration contract",
    "Authority / legacy contract"
  ],
  "soul_contract_meaning_keys": [
    "karmic_refinement_contract",
    "leadership_manifestation_contract",
    "creative_transmission_contract",
    "builder_stewardship_contract",
    "karmic_restoration_contract",
    "authority_legacy_contract",
    "default"
  ],
  "life_mission_themes": [
    "Learning right use of power, wealth, and authority"
  ],
  "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": 3,
      "theme": "Expression and joy"
    },
    {
      "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": "Builder / Organizer Gift",
      "source_number": 8
    },
    {
      "theme": "Adaptability and movement",
      "source_number": 5
    },
    {
      "theme": "Nurturing and responsibility",
      "source_number": 6
    }
  ],
  "spiritual_lessons": [
    "Use power, success, and influence in service of alignment rather than ego",
    "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": [
      5,
      6
    ],
    "karmic_debt_numbers": [
      16
    ],
    "karmic_lesson_numbers": [
      2,
      3,
      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": "72a7f5ba635aaa85",
    "quota": "unlimited",
    "usage_tracking": true,
    "premium_spiritual_report": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "1.0.2",
    "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-08-17T17:53:28.062544+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.