POST/v1/numerology/profile

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.

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

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

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

Reserved; product endpoints are not feature-gated by plan (quota differs by tier).

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

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