POST/v1/numerology/expression

Expression (Destiny) Number

Calculates the Expression (Destiny) number from the full name. Uses all letters with Pythagorean values, reducing each name part separately before summing (Goodwin method). Preserves master numbers 11, 22, 33.

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

data.is_master_number

boolean

data.karmic_debt_number

integer | null

Errors

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

API key tier does not include this endpoint.

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
• Karmic Lessons
• Get life path number
• Maturity (Realization) Number
• Generate numerology profile
• Personality Number
• Soul Urge (Heart's Desire) Number

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/numerology/expression" \
  -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.expression_number(name_only_request=request)
    print(result)

TypeScript

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

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

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

console.log(result.data);

Response

200 OK·application/jsonsigned

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