POST/v1/numerology/profile

Generate numerology profile

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

Request parameters

namerequired

string

Person name used for numerology calculations (aligned with BirthInput name)

daterequired

string (date)

Birth date (aligned with BirthInput date, YYYY-MM-DD)

current_yearoptional

integer | null

Optional target year override for annual calculations

Response fields

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

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

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

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

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

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

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

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

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

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

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 (1-9, 11, 22 or 33) or challenge (0-8) number

data.pinnacles[].start_age

integer

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

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 (1-9, 11, 22 or 33) or challenge (0-8) number

data.challenges[].start_age

integer

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

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]

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)

data.summary

string

Overall numerology summary

data.key_traits

array[string]

Key personality traits

Errors

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

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

Request

POST·application/json

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);

Response

200 OK·application/jsonsigned

{
  "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"
    ]
  }
}