POST/v1/numerology/soul-urge

Soul Urge (Heart's Desire) Number

Calculates the Soul Urge number from vowels (A, E, I, O, U) in the full name. Reduces each name part separately (11, 22, 33 kept). Y is treated as a consonant in this implementation. karmic_debt_number is 13, 14, 16 or 19 when it appears anywhere in the reduction of the total.

Request parameters

namerequired

string

Full name (first and last)

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.number

integer

1-9, or master number 11, 22 or 33

data.is_master_number

boolean

data.karmic_debt_number

integer | null

Karmic debt: 13, 14, 16 or 19 met anywhere in the reduction of the name total (reduced name parts added; a one-word name uses its letter total), e.g. 58 → 13 → 4 is 13; null when none

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
• Generate numerology profile
• Personality Number

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/numerology/soul-urge" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Arjun Mehta"}'

Python

import asterwise
from asterwise.api.numerology_api import NumerologyApi
from asterwise.models.name_only_request import NameOnlyRequest

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

request = NameOnlyRequest(
    name="Arjun Mehta",
)

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

TypeScript

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

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

const result = await soulUrgeNumber({
  client,
  body: {
      "name": "Arjun Mehta"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "number": 1,
    "is_master_number": false,
    "karmic_debt_number": null
  }
}