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.

Endpoint

POST /v1/numerology/expression

Request parameters

Field	Type	Required	Description
name	string	Yes	Full name (first and last)

Example request

curl
Python
TypeScript

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

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)

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

Example response

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

Response fields

Field	Type	Description
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

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

Endpoint​

Request parameters​

Example request​

Example response​

Response fields​

Errors​

Related endpoints​