---
title: "Generate numerology profile"
method: POST
path: "/v1/numerology/profile"
tags: ["Numerology"]
---

# Generate numerology profile

`POST /v1/numerology/profile`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/numerology/profile`
- Auth: HTTP bearer

Builds a complete numerology profile from name and birth date (BirthInput-aligned: `name`, `date`). Returns core numbers, interpretations, cycles, and supportive metadata.

## Request body

- NumerologyRequest
  - `name` string, required: Person name used for numerology calculations (aligned with BirthInput `name`)
  - `date` string, date, required: Birth date (aligned with BirthInput `date`, YYYY-MM-DD)
  - `current_year` integer, nullable: Optional target year override for annual calculations

## Response `200`

Full numerology profile with core number interpretations

- ApiResponseNumerologyProfileResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` NumerologyProfileResponse, required
    - `life_path` CoreNumber, required: Model for a single numerology number with interpretation.
      - `number` union, required: The calculated number (1-9, 11, 22, 33, or karmic debt like 13/4)
        - integer
        - string
      - `reduced_number` integer, required: The final reduced number (1-9)
      - `is_master_number` boolean: Whether this is a master number (11, 22, 33)
      - `is_karmic_debt` boolean: Whether this has karmic debt
      - `karmic_debt_number` integer, nullable: Karmic debt: 13, 14, 16 or 19 met anywhere in the reduction of the number's total (e.g. 58 → 13 → 4 is 13); null when none
      - `interpretation` string, required: Detailed interpretation of the number
      - `keywords` string[]: Key traits and characteristics
    - `expression` CoreNumber, required: Model for a single numerology number with interpretation.
      - `number` union, required: The calculated number (1-9, 11, 22, 33, or karmic debt like 13/4)
        - integer
        - string
      - `reduced_number` integer, required: The final reduced number (1-9)
      - `is_master_number` boolean: Whether this is a master number (11, 22, 33)
      - `is_karmic_debt` boolean: Whether this has karmic debt
      - `karmic_debt_number` integer, nullable: Karmic debt: 13, 14, 16 or 19 met anywhere in the reduction of the number's total (e.g. 58 → 13 → 4 is 13); null when none
      - `interpretation` string, required: Detailed interpretation of the number
      - `keywords` string[]: Key traits and characteristics
    - `soul_urge` CoreNumber, required: Model for a single numerology number with interpretation.
      - `number` union, required: The calculated number (1-9, 11, 22, 33, or karmic debt like 13/4)
        - integer
        - string
      - `reduced_number` integer, required: The final reduced number (1-9)
      - `is_master_number` boolean: Whether this is a master number (11, 22, 33)
      - `is_karmic_debt` boolean: Whether this has karmic debt
      - `karmic_debt_number` integer, nullable: Karmic debt: 13, 14, 16 or 19 met anywhere in the reduction of the number's total (e.g. 58 → 13 → 4 is 13); null when none
      - `interpretation` string, required: Detailed interpretation of the number
      - `keywords` string[]: Key traits and characteristics
    - `personality` CoreNumber, required: Model for a single numerology number with interpretation.
      - `number` union, required: The calculated number (1-9, 11, 22, 33, or karmic debt like 13/4)
        - integer
        - string
      - `reduced_number` integer, required: The final reduced number (1-9)
      - `is_master_number` boolean: Whether this is a master number (11, 22, 33)
      - `is_karmic_debt` boolean: Whether this has karmic debt
      - `karmic_debt_number` integer, nullable: Karmic debt: 13, 14, 16 or 19 met anywhere in the reduction of the number's total (e.g. 58 → 13 → 4 is 13); null when none
      - `interpretation` string, required: Detailed interpretation of the number
      - `keywords` string[]: Key traits and characteristics
    - `birth_day` CoreNumber, required: Model for a single numerology number with interpretation.
      - `number` union, required: The calculated number (1-9, 11, 22, 33, or karmic debt like 13/4)
        - integer
        - string
      - `reduced_number` integer, required: The final reduced number (1-9)
      - `is_master_number` boolean: Whether this is a master number (11, 22, 33)
      - `is_karmic_debt` boolean: Whether this has karmic debt
      - `karmic_debt_number` integer, nullable: Karmic debt: 13, 14, 16 or 19 met anywhere in the reduction of the number's total (e.g. 58 → 13 → 4 is 13); null when none
      - `interpretation` string, required: Detailed interpretation of the number
      - `keywords` string[]: Key traits and characteristics
    - `personal_year` PersonalYear: Model for personal year calculation.
      - `year` integer, required: The year being calculated
      - `personal_year_number` integer, required: Personal year number (1-9)
      - `theme` string, required: Main theme for the year
      - `interpretation` string, required: Detailed interpretation
      - `opportunities` string[]: Opportunities this year
      - `challenges` string[]: Challenges to watch for
      - `advice` string, required: Advice for the year
    - `pinnacles` PinnacleChallenge[]: Life pinnacle cycles
      - `number` integer, required: The pinnacle (1-9, 11, 22 or 33) or challenge (0-8) number
      - `start_age` integer, required: Starting age for this cycle. The first cycle ends at 36 minus the Life Path (a master Life Path counted as its digit: 11 → 2), then 9 years each
      - `end_age` integer, nullable: Ending age for this cycle (None for last cycle)
      - `interpretation` string, required: Interpretation for this cycle
      - `focus_areas` string[]: Key focus areas during this cycle
    - `challenges` PinnacleChallenge[]: Life challenge cycles
      - `number` integer, required: The pinnacle (1-9, 11, 22 or 33) or challenge (0-8) number
      - `start_age` integer, required: Starting age for this cycle. The first cycle ends at 36 minus the Life Path (a master Life Path counted as its digit: 11 → 2), then 9 years each
      - `end_age` integer, nullable: Ending age for this cycle (None for last cycle)
      - `interpretation` string, required: Interpretation for this cycle
      - `focus_areas` string[]: Key focus areas during this cycle
    - `lucky_numbers` integer[]: Six lucky numbers, no repeats: first the Life Path, Expression, Soul Urge, Personality and Birth Day (these may be master numbers 11, 22, 33), then digits 1-9 from the birth date in ascending order, topped up with unused digits 1-9 (at most 9 are guaranteed)
    - `summary` string, required: Overall numerology summary
    - `key_traits` string[]: Key personality traits

## Other responses

- `401`: Authentication failed
- `403`: Authorization failed
- `404`: Resource not found
- `413`: Payload too large
- `422`: Validation error
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream provider error
- `503`: Service unavailable

---

[API](https://skmtc.dev/asterwise/apis/asterwise-api.md) · [All operations](https://skmtc.dev/asterwise/apis/asterwise-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asterwise/apis/asterwise-api/revisions/3c4bbb1194e2?raw)