---
title: "Calculate a versioned numerology profile"
method: POST
path: "/api/v1/numerology/profile"
tags: ["Numerology", "numerology"]
---

# Calculate a versioned numerology profile

`POST /api/v1/numerology/profile`

## Request

- Base URL: `https://api.freeastroapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.freeastroapi.com/api/v1/numerology/profile`
- Auth: none declared

Calculate without persisting subject names, dates, or derived results.

## Request body

- NumerologyProfileRequest
  - `method` union, required
    - PythagoreanMethodRequest
      - `system` 'pythagorean', required
      - `profile` 'pythagorean-component-preserve-core-v1' | 'pythagorean-raw-date-preserve-core-v1' | 'standard' | 'raw_date'
      - `master_policy` 'preserve_core_11_22_33'
      - `compound_policy` 'root_only' | 'compound_and_root' | 'full_trace'
    - ChaldeanMethodRequest
      - `system` 'chaldean', required
      - `profile` 'chaldean-cheiro-current-name-v1' | 'chaldean-cheiro-birth-name-v1' | 'current_name' | 'birth_name', nullable
      - `master_policy` 'reduce_all'
      - `compound_policy` 'compound_and_root' | 'full_trace'
    - KabbalahMethodRequest
      - `system` 'kabbalah', required
      - `profile` 'kabbalah-gematria-hechrechi-v1' | 'kabbalah-gematria-siduri-v1' | 'kabbalah-gematria-katan-v1' | 'kabbalah-gematria-katan-mispari-v1' | 'kabbalah-gematria-millui-alef-v1' | 'kabbalah-gematria-millui-alef-reduced-v1' | 'standard' | 'siduri' | 'ordinal' | 'katan' | 'reduced_letters' | 'katan_mispari' | 'reduced_total' | 'millui' | 'full_letter_names' | 'millui_reduced' | 'full_letter_names_reduced'
      - `master_policy` 'not_applicable'
      - `compound_policy` 'compound_and_root' | 'full_trace'
      - `name_source` 'birth' | 'current', nullable
    - AnkJyotishMethodRequest
      - `system` 'ank_jyotish', required
      - `profile` 'ank-jyotish-civil-cheiro-navagraha-reduce-all-v1' | 'standard'
      - `master_policy` 'reduce_all'
      - `compound_policy` 'compound_and_root' | 'full_trace'
      - `name_source` 'birth' | 'current', nullable
  - `subject` NumerologySubject, required
    - `birth_date` string, date, nullable: Gregorian civil birth date; required by Pythagorean and Ank Jyotish profiles
    - `name` NumerologyNameInput
      - `birth` string, nullable
      - `current` string, nullable
      - `script` string: ISO 15924 script code
      - `transliteration` TransliterationInput
        - `profile` string, nullable
        - `birth` string, nullable
        - `current` string, nullable
    - `calendar` 'gregory'
    - `locale` 'en' | 'en-IN' | 'hi' | 'hi-IN'
    - `city` string, nullable: City used when timezone is AUTO
    - `lat` number, nullable
    - `lng` number, nullable
    - `tz_str` string, nullable: IANA timezone or AUTO, using the natal endpoint convention
  - `date_context` NumerologyDateContextRequest
    - `reference_date` string, date, nullable: Target date for personal cycles
    - `year_anchor` 'calendar_year'
  - `include_interpretations` boolean

## Response `200`

Successful Response

- NumerologyProfileResponse
  - `meta` NumerologyMetadata, required
    - `schema_version` '2.0', required
    - `source_profile_version` string, required
    - `method` union, required
      - ResolvedPythagoreanMethod
        - `system` 'pythagorean', required
        - `profile` 'pythagorean-component-preserve-core-v1' | 'pythagorean-raw-date-preserve-core-v1', required
        - `master_policy` 'preserve_core_11_22_33', required
        - `compound_policy` 'root_only' | 'compound_and_root' | 'full_trace', required
      - ResolvedChaldeanMethod
        - `system` 'chaldean', required
        - `profile` 'chaldean-cheiro-current-name-v1' | 'chaldean-cheiro-birth-name-v1', required
        - `master_policy` 'reduce_all', required
        - `compound_policy` 'compound_and_root' | 'full_trace', required
      - ResolvedKabbalahMethod
        - `system` 'kabbalah', required
        - `profile` 'kabbalah-gematria-hechrechi-v1' | 'kabbalah-gematria-siduri-v1' | 'kabbalah-gematria-katan-v1' | 'kabbalah-gematria-katan-mispari-v1' | 'kabbalah-gematria-millui-alef-v1' | 'kabbalah-gematria-millui-alef-reduced-v1', required
        - `master_policy` 'not_applicable', required
        - `compound_policy` 'compound_and_root' | 'full_trace', required
        - `name_source` 'birth' | 'current', required
      - ResolvedAnkJyotishMethod
        - `system` 'ank_jyotish', required
        - `profile` 'ank-jyotish-civil-cheiro-navagraha-reduce-all-v1', required
        - `master_policy` 'reduce_all', required
        - `compound_policy` 'compound_and_root' | 'full_trace', required
        - `name_source` 'birth' | 'current', required
    - `date_context` ResolvedDateContext
      - `reference_date` string, date, required
      - `timezone_requested` string, nullable
      - `timezone_resolved` string, nullable
      - `calendar` 'gregory', required
      - `year_anchor` 'calendar_year', required
    - `calculation_policy` CalculationPolicy, required
      - `preserved_master_numbers` integer[], required
      - `name_normalization` string, required
      - `y_policy` string, required
      - `alphabet_table_id` string, nullable
      - `birth_date_boundary` 'civil_midnight', nullable
      - `calendar` 'gregory', nullable
      - `date_digit_order` 'DDMMYYYY', nullable
      - `profile_type` 'explicit_composite_modern', nullable
    - `graha_mapping` GrahaMapping
      - `id` string, required
      - `romanization_scheme` 'common_indian_english_and_iast', required
      - `hindi_script` 'Deva', required
      - `localization_source_ids` string[], required
      - `roots` RulingGraha[], required
        - `number` integer, required
        - `id` 'surya' | 'chandra' | 'guru' | 'rahu' | 'budha' | 'shukra' | 'ketu' | 'shani' | 'mangala', required
        - `english_name` string, required
        - `common_romanization` string, required
        - `iast_name` string, required
        - `hindi_name` string, required
        - `hindi_aliases` string[], required
    - `interpretations` InterpretationResolutionMetadata, required
      - `requested` boolean, required
      - `default_included` unknown, required
      - `locale_requested` string, required
      - `locale_resolved` string, nullable
      - `content_version` string, required
      - `personal_interpretation` 'available' | 'available_with_compound_limit' | 'unavailable', required
      - `content_kinds` string[], required
    - `privacy` PrivacyMetadata, required
      - `persisted` unknown, required
      - `retention` 'none_by_numerology_endpoint', required
      - `request_data_stored_by_endpoint` unknown, required
  - `normalized_input` NormalizedInput, required
    - `birth_date` string, date, nullable
    - `calendar` 'gregory', required
    - `birth_date_boundary` 'civil_midnight', nullable
    - `locale` 'en' | 'en-IN' | 'hi' | 'hi-IN', required
    - `name` NormalizedName, required
      - `original_birth` string, nullable
      - `original_current` string, nullable
      - `birth` string, nullable
      - `current` string, nullable
      - `script` string, required
      - `script_detected` string, nullable
      - `transliteration` NormalizedTransliteration, required
        - `profile` string, nullable
        - `birth` string, nullable
        - `current` string, nullable
      - `source_used_for_name_numbers` 'birth' | 'current', nullable
      - `source_reason` string, nullable
  - `data` union, required
    - PythagoreanData
      - `kind` 'pythagorean', required
      - `core` CoreNumbers, required
        - `life_path` NumberResult, required
          - `calculation` string, required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, nullable
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` integer, nullable
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` KarmicDebt[], required
            - `number` integer, required
            - `root` integer, required
            - `value_display` string, required
            - `source` string, required
            - `origin` string, required
            - `interpretation_key` string, nullable
            - `interpretation_ref` InterpretationRef
              - …
            - `content` ArchetypeInterpretation
              - …
          - `interpretation_key` string, nullable
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, nullable
          - `content` union
            - ArchetypeInterpretation
              - …
            - ChaldeanNameInterpretation
              - …
            - GematriaMethodExplanation
              - …
        - `birthday` NumberResult, required
          - `calculation` string, required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, nullable
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` integer, nullable
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` KarmicDebt[], required
            - `number` integer, required
            - `root` integer, required
            - `value_display` string, required
            - `source` string, required
            - `origin` string, required
            - `interpretation_key` string, nullable
            - `interpretation_ref` InterpretationRef
              - …
            - `content` ArchetypeInterpretation
              - …
          - `interpretation_key` string, nullable
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, nullable
          - `content` union
            - ArchetypeInterpretation
              - …
            - ChaldeanNameInterpretation
              - …
            - GematriaMethodExplanation
              - …
        - `attitude` NumberResult, required
          - `calculation` string, required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, nullable
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` integer, nullable
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` KarmicDebt[], required
            - `number` integer, required
            - `root` integer, required
            - `value_display` string, required
            - `source` string, required
            - `origin` string, required
            - `interpretation_key` string, nullable
            - `interpretation_ref` InterpretationRef
              - …
            - `content` ArchetypeInterpretation
              - …
          - `interpretation_key` string, nullable
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, nullable
          - `content` union
            - ArchetypeInterpretation
              - …
            - ChaldeanNameInterpretation
              - …
            - GematriaMethodExplanation
              - …
      - `cycles` PersonalCycles, required
        - `personal_year` NumberResult, required
          - `calculation` string, required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, nullable
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` integer, nullable
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` KarmicDebt[], required
            - `number` integer, required
            - `root` integer, required
            - `value_display` string, required
            - `source` string, required
            - `origin` string, required
            - `interpretation_key` string, nullable
            - `interpretation_ref` InterpretationRef
              - …
            - `content` ArchetypeInterpretation
              - …
          - `interpretation_key` string, nullable
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, nullable
          - `content` union
            - ArchetypeInterpretation
              - …
            - ChaldeanNameInterpretation
              - …
            - GematriaMethodExplanation
              - …
        - `personal_month` NumberResult, required
          - `calculation` string, required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, nullable
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` integer, nullable
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` KarmicDebt[], required
            - `number` integer, required
            - `root` integer, required
            - `value_display` string, required
            - `source` string, required
            - `origin` string, required
            - `interpretation_key` string, nullable
            - `interpretation_ref` InterpretationRef
              - …
            - `content` ArchetypeInterpretation
              - …
          - `interpretation_key` string, nullable
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, nullable
          - `content` union
            - ArchetypeInterpretation
              - …
            - ChaldeanNameInterpretation
              - …
            - GematriaMethodExplanation
              - …
        - `personal_day` NumberResult, required
          - `calculation` string, required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, nullable
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` integer, nullable
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` KarmicDebt[], required
            - `number` integer, required
            - `root` integer, required
            - `value_display` string, required
            - `source` string, required
            - `origin` string, required
            - `interpretation_key` string, nullable
            - `interpretation_ref` InterpretationRef
              - …
            - `content` ArchetypeInterpretation
              - …
          - `interpretation_key` string, nullable
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, nullable
          - `content` union
            - ArchetypeInterpretation
              - …
            - ChaldeanNameInterpretation
              - …
            - GematriaMethodExplanation
              - …
      - `life_cycles` LifeCycles, required
        - `period_cycles` TimedNumberResult[], required
          - `calculation` string, required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, nullable
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` integer, nullable
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` KarmicDebt[], required
            - `number` integer, required
            - `root` integer, required
            - `value_display` string, required
            - `source` string, required
            - `origin` string, required
            - `interpretation_key` string, nullable
            - `interpretation_ref` InterpretationRef
              - …
            - `content` ArchetypeInterpretation
              - …
          - `interpretation_key` string, nullable
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, nullable
          - `content` union
            - ArchetypeInterpretation
              - …
            - ChaldeanNameInterpretation
              - …
            - GematriaMethodExplanation
              - …
          - `age_start` integer, required
          - `age_end_exclusive` integer, nullable
        - `pinnacles` TimedNumberResult[], required
          - `calculation` string, required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, nullable
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` integer, nullable
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` KarmicDebt[], required
            - `number` integer, required
            - `root` integer, required
            - `value_display` string, required
            - `source` string, required
            - `origin` string, required
            - `interpretation_key` string, nullable
            - `interpretation_ref` InterpretationRef
              - …
            - `content` ArchetypeInterpretation
              - …
          - `interpretation_key` string, nullable
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, nullable
          - `content` union
            - ArchetypeInterpretation
              - …
            - ChaldeanNameInterpretation
              - …
            - GematriaMethodExplanation
              - …
          - `age_start` integer, required
          - `age_end_exclusive` integer, nullable
        - `challenges` NumberResult[], required
          - `calculation` string, required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, nullable
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` integer, nullable
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` KarmicDebt[], required
            - `number` integer, required
            - `root` integer, required
            - `value_display` string, required
            - `source` string, required
            - `origin` string, required
            - `interpretation_key` string, nullable
            - `interpretation_ref` InterpretationRef
              - …
            - `content` ArchetypeInterpretation
              - …
          - `interpretation_key` string, nullable
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, nullable
          - `content` union
            - ArchetypeInterpretation
              - …
            - ChaldeanNameInterpretation
              - …
            - GematriaMethodExplanation
              - …
      - `name_analysis` NameAnalysis
        - `source_name` 'birth', required
        - `expression` NumberResult, required
          - `calculation` string, required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, nullable
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` integer, nullable
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` KarmicDebt[], required
            - `number` integer, required
            - `root` integer, required
            - `value_display` string, required
            - `source` string, required
            - `origin` string, required
            - `interpretation_key` string, nullable
            - `interpretation_ref` InterpretationRef
              - …
            - `content` ArchetypeInterpretation
              - …
          - `interpretation_key` string, nullable
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, nullable
          - `content` union
            - ArchetypeInterpretation
              - …
            - ChaldeanNameInterpretation
              - …
            - GematriaMethodExplanation
              - …
        - `soul_urge` NumberResult, required
          - `calculation` string, required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, nullable
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` integer, nullable
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` KarmicDebt[], required
            - `number` integer, required
            - `root` integer, required
            - `value_display` string, required
            - `source` string, required
            - `origin` string, required
            - `interpretation_key` string, nullable
            - `interpretation_ref` InterpretationRef
              - …
            - `content` ArchetypeInterpretation
              - …
          - `interpretation_key` string, nullable
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, nullable
          - `content` union
            - ArchetypeInterpretation
              - …
            - ChaldeanNameInterpretation
              - …
            - GematriaMethodExplanation
              - …
        - `personality` NumberResult, required
          - `calculation` string, required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, nullable
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` integer, nullable
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` KarmicDebt[], required
            - `number` integer, required
            - `root` integer, required
            - `value_display` string, required
            - `source` string, required
            - `origin` string, required
            - `interpretation_key` string, nullable
            - `interpretation_ref` InterpretationRef
              - …
            - `content` ArchetypeInterpretation
              - …
          - `interpretation_key` string, nullable
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, nullable
          - `content` union
            - ArchetypeInterpretation
              - …
            - ChaldeanNameInterpretation
              - …
            - GematriaMethodExplanation
              - …
        - `maturity` NumberResult, required
          - `calculation` string, required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, nullable
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` integer, nullable
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` KarmicDebt[], required
            - `number` integer, required
            - `root` integer, required
            - `value_display` string, required
            - `source` string, required
            - `origin` string, required
            - `interpretation_key` string, nullable
            - `interpretation_ref` InterpretationRef
              - …
            - `content` ArchetypeInterpretation
              - …
          - `interpretation_key` string, nullable
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, nullable
          - `content` union
            - ArchetypeInterpretation
              - …
            - ChaldeanNameInterpretation
              - …
            - GematriaMethodExplanation
              - …
        - `karmic_lessons` integer[], required
        - `karmic_lesson_content` NumerologyFacetContent[], nullable
          - `value` integer, required
          - `interpretation_key` string, required
          - `interpretation_ref` InterpretationRef, required
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `content` ArchetypeInterpretation
            - `availability` 'available' | 'partial', required
            - `personal_interpretation` unknown, required
            - `content_key` string, required
            - `content_id` string, required
            - `content_version` string, required
            - `locale` string, required
            - `claims_mode` 'symbolic_reflective', required
            - `source_ids` string[], required
            - `source_refs` ContentSourceRef[], required
              - …
            - `provenance_note` string, required
            - `disclaimer` string, required
            - `kind` 'archetype_interpretation', required
            - `coverage` 'exact', required
            - `title` string, required
            - `summary` string, required
            - `strengths` string[], required
            - `cautions` string[], required
            - `guidance` string, required
        - `hidden_passions` integer[], required
        - `hidden_passion_content` NumerologyFacetContent[], nullable
          - `value` integer, required
          - `interpretation_key` string, required
          - `interpretation_ref` InterpretationRef, required
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `content` ArchetypeInterpretation
            - `availability` 'available' | 'partial', required
            - `personal_interpretation` unknown, required
            - `content_key` string, required
            - `content_id` string, required
            - `content_version` string, required
            - `locale` string, required
            - `claims_mode` 'symbolic_reflective', required
            - `source_ids` string[], required
            - `source_refs` ContentSourceRef[], required
              - …
            - `provenance_note` string, required
            - `disclaimer` string, required
            - `kind` 'archetype_interpretation', required
            - `coverage` 'exact', required
            - `title` string, required
            - `summary` string, required
            - `strengths` string[], required
            - `cautions` string[], required
            - `guidance` string, required
        - `present_digits` integer[], required
        - `missing_digits` integer[], required
        - `frequency_grid` object, required
        - `balance` NumberResult, required
          - `calculation` string, required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, nullable
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` integer, nullable
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` KarmicDebt[], required
            - `number` integer, required
            - `root` integer, required
            - `value_display` string, required
            - `source` string, required
            - `origin` string, required
            - `interpretation_key` string, nullable
            - `interpretation_ref` InterpretationRef
              - …
            - `content` ArchetypeInterpretation
              - …
          - `interpretation_key` string, nullable
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, nullable
          - `content` union
            - ArchetypeInterpretation
              - …
            - ChaldeanNameInterpretation
              - …
            - GematriaMethodExplanation
              - …
    - ChaldeanData
      - `kind` 'chaldean', required
      - `chaldean_name_analysis` ChaldeanNameAnalysis, required
        - `source_name` 'birth' | 'current', required
        - `source_reason` string, required
        - `alphabet_table_id` string, required
        - `name_number` NumberResult, required
          - `calculation` string, required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, nullable
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` integer, nullable
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` KarmicDebt[], required
            - `number` integer, required
            - `root` integer, required
            - `value_display` string, required
            - `source` string, required
            - `origin` string, required
            - `interpretation_key` string, nullable
            - `interpretation_ref` InterpretationRef
              - …
            - `content` ArchetypeInterpretation
              - …
          - `interpretation_key` string, nullable
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, nullable
          - `content` union
            - ArchetypeInterpretation
              - …
            - ChaldeanNameInterpretation
              - …
            - GematriaMethodExplanation
              - …
    - KabbalahData
      - `kind` 'kabbalah', required
      - `kabbalah_name_analysis` KabbalahNameAnalysis, required
        - `source_name` 'birth' | 'current', required
        - `source_reason` string, required
        - `alphabet_table_id` string, required
        - `profile_mode` string, required
        - `name_value` NumberResult, required
          - `calculation` string, required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, nullable
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` integer, nullable
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` KarmicDebt[], required
            - `number` integer, required
            - `root` integer, required
            - `value_display` string, required
            - `source` string, required
            - `origin` string, required
            - `interpretation_key` string, nullable
            - `interpretation_ref` InterpretationRef
              - …
            - `content` ArchetypeInterpretation
              - …
          - `interpretation_key` string, nullable
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, nullable
          - `content` union
            - ArchetypeInterpretation
              - …
            - ChaldeanNameInterpretation
              - …
            - GematriaMethodExplanation
              - …
    - AnkJyotishData
      - `kind` 'ank_jyotish', required
      - `core` AnkJyotishCore, required
        - `moolank` AnkJyotishNumberResult, required
          - `calculation` 'moolank' | 'bhagyank' | 'namank', required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, required
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` unknown
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` unknown[], required
            - unknown
          - `interpretation_key` unknown
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, required
          - `ruling_graha` RulingGraha, required
            - `number` integer, required
            - `id` 'surya' | 'chandra' | 'guru' | 'rahu' | 'budha' | 'shukra' | 'ketu' | 'shani' | 'mangala', required
            - `english_name` string, required
            - `common_romanization` string, required
            - `iast_name` string, required
            - `hindi_name` string, required
            - `hindi_aliases` string[], required
        - `bhagyank` AnkJyotishNumberResult, required
          - `calculation` 'moolank' | 'bhagyank' | 'namank', required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, required
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` unknown
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` unknown[], required
            - unknown
          - `interpretation_key` unknown
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, required
          - `ruling_graha` RulingGraha, required
            - `number` integer, required
            - `id` 'surya' | 'chandra' | 'guru' | 'rahu' | 'budha' | 'shukra' | 'ketu' | 'shani' | 'mangala', required
            - `english_name` string, required
            - `common_romanization` string, required
            - `iast_name` string, required
            - `hindi_name` string, required
            - `hindi_aliases` string[], required
        - `namank` AnkJyotishNumberResult, required
          - `calculation` 'moolank' | 'bhagyank' | 'namank', required
          - `label` string, required
          - `value` integer, required
          - `raw_total` integer, required
          - `compound` integer, nullable
          - `root` integer, required
          - `value_display` string, required
          - `master_number` unknown
          - `aliases` string[], required
          - `method_variance` string, required
          - `warnings` NumberWarning[], required
            - `code` string, required
            - `message` string, required
          - `karmic_debts` unknown[], required
            - unknown
          - `interpretation_key` unknown
          - `interpretation_ref` InterpretationRef
            - `key` string, nullable
            - `status` 'available' | 'partial' | 'unavailable', required
            - `locale_requested` string, required
            - `locale_resolved` string, nullable
            - `content_version` string, required
          - `reduction_path` integer[], nullable
          - `steps` object[], nullable
          - `details` object, required
          - `ruling_graha` RulingGraha, required
            - `number` integer, required
            - `id` 'surya' | 'chandra' | 'guru' | 'rahu' | 'budha' | 'shukra' | 'ketu' | 'shani' | 'mangala', required
            - `english_name` string, required
            - `common_romanization` string, required
            - `iast_name` string, required
            - `hindi_name` string, required
            - `hindi_aliases` string[], required

## Other responses

- `400`: Numerology date-context resolution failed
- `409`: Numerology policies are incompatible with the selected profile
- `422`: Numerology request validation failed

---

[API](https://skmtc.dev/freeastroapi/apis/astroservice-api.md) · [All operations](https://skmtc.dev/freeastroapi/apis/astroservice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/freeastroapi/apis/astroservice-api/revisions/0c9b4a759522?raw)