---
title: "Expression (Destiny) Number"
method: POST
path: "/v1/numerology/expression"
tags: ["Numerology"]
---

# Expression (Destiny) Number

`POST /v1/numerology/expression`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/numerology/expression`
- Auth: HTTP bearer

Calculates the Expression (Destiny) number from the full name. Uses all letters with Pythagorean values, reducing each name part separately before summing (Decoz method). Preserves master numbers 11, 22, 33. karmic_debt_number is 13, 14, 16 or 19 when it appears anywhere in the reduction of the total (e.g. 58 → 13 → 4).

## Request body

- NameOnlyRequest
  - `name` string, required: Full name (first and last)

## Response `200`

Successful Response

- ApiResponseNameNumberResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` NameNumberResponse, required
    - `number` integer, required: 1-9, or master number 11, 22 or 33
    - `is_master_number` boolean, required
    - `karmic_debt_number` integer, nullable: 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

## Other responses

- `401`: Authentication failed
- `403`: Authorization failed
- `404`: Resource not found
- `413`: Payload too large
- `422`: Validation error
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream provider error
- `503`: Service unavailable

---

[API](https://skmtc.dev/asterwise/apis/asterwise-api.md) · [All operations](https://skmtc.dev/asterwise/apis/asterwise-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asterwise/apis/asterwise-api/revisions/3c4bbb1194e2?raw)