---
title: "Soul Urge / Heart's Desire (vedic)"
method: POST
path: "/numerology/vedic/soul-urge"
tags: ["Numerology: Vedic"]
---

# Soul Urge / Heart's Desire (vedic)

`POST /numerology/vedic/soul-urge`

## Request

- Base URL: `https://api.astroway.info/v1`
- URL: `https://api.astroway.info/v1/numerology/vedic/soul-urge`
- Auth: API key in header `X-Api-Key`

Calculate the Soul Urge number from the vowels of the full birth name. Numerology: Vedic system.

## Query parameters

- `fields` string
- `precision` integer

## Request body

- NumerologyNameDate
  - `name` string, required
  - `date` string, required

## Response `200`

Successful calculation

- object
  - `ok` boolean
  - `data` object
    - `system` string, nullable
    - `name` string, nullable
    - `date` string, nullable
    - `soulUrge` object, nullable
      - `raw` number, nullable
      - `reduced` number, nullable
      - `isMaster` boolean, nullable
      - `steps` number[], nullable
      - `meaning` object, nullable
        - `number` number, nullable
        - `archetype` string, nullable
        - `strengths` string[], nullable
        - `shortRead` string, nullable

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key

## Changes

- **2026-09-21** `b64222844186`: 2 info
  - added the new optional `query` request parameter `fields`
  - added the new optional `query` request parameter `precision`
- **2026-08-23** `529d7d36d7d6`: 1 warning, 1 info
  - removed the optional property `data/soulurge` from the response with the `200` status
  - added the optional property `data/soulUrge` to the response with the `200` status
- **2026-08-22** `5a17388652f3`: 2 breaking
  - added the new required request property `date`
  - added the new required request property `name`
- **2026-08-14** `994755209cea`: 2 info
  - api tag `Numerology: Vedic` added
  - api tag `Numerology — Vedic` removed

[Operation history](https://skmtc.dev/astroway/apis/astroway-calculation-api/changes/numerology/vedic/soul-urge/post.md)

---

[API](https://skmtc.dev/astroway/apis/astroway-calculation-api.md) · [All operations](https://skmtc.dev/astroway/apis/astroway-calculation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/astroway/apis/astroway-calculation-api/revisions/593d763ba9a5?raw)