---
title: "Get life path number"
method: POST
path: "/v1/numerology/life-path"
tags: ["Numerology"]
---

# Get life path number

`POST /v1/numerology/life-path`

## Request

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

Calculates the life path number for a birth date and returns interpretation details. Body: `date` (YYYY-MM-DD). Returns number, master/karmic markers, and guidance keywords.

## Request body

- LifePathRequest: POST body for the life path number: the birth date stays out of the URL.
  - `date` string, date, required: Birth date (YYYY-MM-DD)

## Response `200`

Life path number with interpretation metadata

- ApiResponseLifePathResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` LifePathResponse, required
    - `life_path_number` integer, required: Computed life path number
    - `is_master_number` boolean, required: Whether life path is a master number
    - `karmic_debt_number` integer, nullable, required: Karmic debt: 13, 14, 16 or 19 met anywhere in the reduction of the birth-date total; null when none
    - `interpretation` string, required: Narrative interpretation for life path number
    - `keywords` string[], required: Keywords associated with the life path number

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