Generate numerology profile

Builds a complete numerology profile from name and birth date (BirthInput-aligned: name, date). Requires authenticated API key access (Core tier or above in product terms). Returns core numbers, interpretations, cycles, and supportive metadata.

Endpoint

POST /v1/numerology/profile

Request parameters

Field	Type	Required	Description
name	string	Yes	Person name used for numerology calculations (aligned with BirthInput name)
date	string (date)	Yes	Birth date (aligned with BirthInput date, YYYY-MM-DD)
current_year	integer | null	No	Optional target year override for annual calculations

Example request

curl

curl -X POST "https://api.asterwise.com/v1/numerology/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Arjun Mehta","date":"1985-11-12"}'

Python

import asterwise
from asterwise.api.numerology_api import NumerologyApi
from asterwise.models.numerology_request import NumerologyRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = NumerologyRequest(
    name="Arjun Mehta",
    date="1985-11-12",
)

with asterwise.ApiClient(configuration) as client:
    api = NumerologyApi(client)
    result = api.numerology_profile(numerology_request=request)
    print(result)

TypeScript

import { createClient, createConfig, numerologyProfile } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await numerologyProfile({
  client,
  body: {
      "name": "Arjun Mehta",
      "date": "1985-11-12"
  },
});

console.log(result.data);

Example response

{
  "success": true,
  "message": "success",
  "data": {
    "life_path": {
      "number": 1,
      "reduced_number": 1,
      "is_master_number": false,
      "is_karmic_debt": false,
      "karmic_debt_number": null,
      "interpretation": "You are a natural leader and pioneer. Your life purpose involves independence, innovation, and breaking new ground. You…",
      "keywords": [
        "Leadership",
        "Independence",
        "... and 3 more items"
      ]
    },
    "expression": {
      "number": 3,
      "reduced_number": 3,
      "is_master_number": false,
      "is_karmic_debt": false,
      "karmic_debt_number": null,
      "interpretation": "You express yourself through creativity and communication. You have artistic talents and the ability to inspire others t…",
      "keywords": [
        "Creativity",
        "Communication",
        "... and 3 more items"
      ]
    },
    "soul_urge": {
      "number": 1,
      "reduced_number": 1,
      "is_master_number": false,
      "is_karmic_debt": false,
      "karmic_debt_number": null,
      "interpretation": "Your soul craves independence and leadership. You are happiest when you can be original, take initiative, and lead other…",
      "keywords": [
        "Independence",
        "Leadership",
        "... and 3 more items"
      ]
    },
    "personality": {
      "number": 11,
      "reduced_number": 2,
      "is_master_number": true,
      "is_karmic_debt": false,
      "karmic_debt_number": null,
      "interpretation": "Others pick up on a refined, intuitive presence — you read as quietly insightful and spiritually tuned-in before you say…",
      "keywords": [
        "Intuition",
        "Inspiration",
        "... and 3 more items"
      ]
    },
    "birth_day": {
      "number": 3,
      "reduced_number": 3,
      "is_master_number": false,
      "is_karmic_debt": false,
      "karmic_debt_number": null,
      "interpretation": "You have a special talent for creative expression and communication. This gift enhances your ability to inspire and ente…",
      "keywords": [
        "Creative talent",
        "Communication",
        "... and 3 more items"
      ]
    },
    "personal_year": null,
    "pinnacles": [
      {
        "number": 5,
        "start_age": 0,
        "end_age": 35,
        "interpretation": "First Pinnacle (5): Focus on embracing change and freedom",
        "focus_areas": [
          "Freedom",
          "Change",
          "... and 2 more items"
        ]
      },
      {
        "number": 8,
        "start_age": 36,
        "end_age": 44,
        "interpretation": "Second Pinnacle (8): Focus on achieving material success and recognition",
        "focus_areas": [
          "Business",
          "Material success",
          "... and 2 more items"
        ]
      },
      "... and 2 more items"
    ],
    "challenges": [
      {
        "number": 1,
        "start_age": 0,
        "end_age": 35,
        "interpretation": "First Challenge (1): Learn to be independent without being selfish or aggressive",
        "focus_areas": [
          "Independence vs. selfishness",
          "Leadership vs. domination",
          "... and 1 more item"
        ]
      },
      {
        "number": 2,
        "start_age": 36,
        "end_age": 44,
        "interpretation": "Second Challenge (2): Learn to cooperate without losing your identity or becoming overly sensitive",
        "focus_areas": [
          "Cooperation vs. submission",
          "Sensitivity vs. over-sensitivity",
          "... and 1 more item"
        ]
      },
      "... and 2 more items"
    ],
    "lucky_numbers": [
      1,
      3,
      "... and 4 more items"
    ],
    "summary": "Your Life Path 1 reveals that You are a natural leader and pioneer. Your life purpose involves independence, innovation,…",
    "key_traits": [
      "Leadership",
      "Independence",
      "... and 2 more items"
    ]
  }
}

Response fields

Field	Type	Description
success	boolean	True if the request succeeded
message	string	Human-readable status message
data	object
data.life_path	object	Model for a single numerology number with interpretation.
data.life_path.number	integer | string	The calculated number (1-9, 11, 22, 33, or karmic debt like 13/4)
data.life_path.reduced_number	integer	The final reduced number (1-9)
data.life_path.is_master_number	boolean	Whether this is a master number (11, 22, 33)
data.life_path.is_karmic_debt	boolean	Whether this has karmic debt
data.life_path.karmic_debt_number	integer | null	The karmic debt number if applicable
data.life_path.interpretation	string	Detailed interpretation of the number
data.life_path.keywords	array[string]	Key traits and characteristics
data.expression	object	Model for a single numerology number with interpretation.
data.expression.number	integer | string	The calculated number (1-9, 11, 22, 33, or karmic debt like 13/4)
data.expression.reduced_number	integer	The final reduced number (1-9)
data.expression.is_master_number	boolean	Whether this is a master number (11, 22, 33)
data.expression.is_karmic_debt	boolean	Whether this has karmic debt
data.expression.karmic_debt_number	integer | null	The karmic debt number if applicable
data.expression.interpretation	string	Detailed interpretation of the number
data.expression.keywords	array[string]	Key traits and characteristics
data.soul_urge	object	Model for a single numerology number with interpretation.
data.soul_urge.number	integer | string	The calculated number (1-9, 11, 22, 33, or karmic debt like 13/4)
data.soul_urge.reduced_number	integer	The final reduced number (1-9)
data.soul_urge.is_master_number	boolean	Whether this is a master number (11, 22, 33)
data.soul_urge.is_karmic_debt	boolean	Whether this has karmic debt
data.soul_urge.karmic_debt_number	integer | null	The karmic debt number if applicable
data.soul_urge.interpretation	string	Detailed interpretation of the number
data.soul_urge.keywords	array[string]	Key traits and characteristics
data.personality	object	Model for a single numerology number with interpretation.
data.personality.number	integer | string	The calculated number (1-9, 11, 22, 33, or karmic debt like 13/4)
data.personality.reduced_number	integer	The final reduced number (1-9)
data.personality.is_master_number	boolean	Whether this is a master number (11, 22, 33)
data.personality.is_karmic_debt	boolean	Whether this has karmic debt
data.personality.karmic_debt_number	integer | null	The karmic debt number if applicable
data.personality.interpretation	string	Detailed interpretation of the number
data.personality.keywords	array[string]	Key traits and characteristics
data.birth_day	object	Model for a single numerology number with interpretation.
data.birth_day.number	integer | string	The calculated number (1-9, 11, 22, 33, or karmic debt like 13/4)
data.birth_day.reduced_number	integer	The final reduced number (1-9)
data.birth_day.is_master_number	boolean	Whether this is a master number (11, 22, 33)
data.birth_day.is_karmic_debt	boolean	Whether this has karmic debt
data.birth_day.karmic_debt_number	integer | null	The karmic debt number if applicable
data.birth_day.interpretation	string	Detailed interpretation of the number
data.birth_day.keywords	array[string]	Key traits and characteristics
data.personal_year	PersonalYear | null	Current or specified year insights
data.pinnacles	array[object]	Life pinnacle cycles
data.pinnacles[].number	integer	The pinnacle or challenge number
data.pinnacles[].start_age	integer	Starting age for this cycle
data.pinnacles[].end_age	integer | null	Ending age for this cycle (None for last cycle)
data.pinnacles[].interpretation	string	Interpretation for this cycle
data.pinnacles[].focus_areas	array[string]	Key focus areas during this cycle
data.challenges	array[object]	Life challenge cycles
data.challenges[].number	integer	The pinnacle or challenge number
data.challenges[].start_age	integer	Starting age for this cycle
data.challenges[].end_age	integer | null	Ending age for this cycle (None for last cycle)
data.challenges[].interpretation	string	Interpretation for this cycle
data.challenges[].focus_areas	array[string]	Key focus areas during this cycle
data.lucky_numbers	array[integer]	Personal lucky numbers
data.summary	string	Overall numerology summary
data.key_traits	array[string]	Key personality traits

Errors

Code	Description	Reference
authentication_failed	Missing or invalid API key.	authentication_failed
ephemeris_unavailable	Upstream ephemeris service error.	ephemeris_unavailable
insufficient_tier	API key tier does not include this endpoint.	insufficient_tier
internal_error	Unexpected server error.	internal_error
ip_rate_limit_exceeded	Too many requests in a short window.	ip_rate_limit_exceeded
payload_too_large	Request body exceeds the size limit.	payload_too_large
resource_not_found	Referenced resource was not found.	resource_not_found
validation_error	Request body failed schema validation.	validation_error

Related endpoints

• Balance Number
• Expression (Destiny) Number
• Karmic Lessons
• Get life path number
• Maturity (Realization) Number
• Personality Number
• Soul Urge (Heart's Desire) Number