POST/api/astro/numerology/vedic/1 credit

Vedic numerology

Vedic numerology: the seven calculations of the Indian system. `moolank` is the root number from the birth day alone, `bhagyank` the destiny number from the full date, and `namank` the name number scored on the Chaldean letter table — Vedic practice borrows that table rather than using one of its own. `vedic_grid` is the 3×3 grid of digit counts, with personal day, month and year cycles alongside. Returns 7 calculations. Send a name and a date of birth. The system is fixed by the route, so a `system` field in the body is ignored — this endpoint cannot return another system's numbers. The parent /api/astro/numerology/ carries all 34 calculations behind a `system` field, and asking for a key that belongs to a different system returns a 400 that fails the WHOLE request. These routes remove that: each asks only for the keys its own system supports.

https://yogataraapi.prahlad.app/api/astro/numerology/vedic/

Test Request

Authentication

Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Request fields

Field	Type	Required	Notes
date_time	string (date-time)	required	The moment to calculate for, ISO 8601. ALWAYS include an offset or a trailing Z - a value with no zone is read as Asia/Kolkata (UTC+05:30), not UTC, and can return the previous day's result with a 200. '2026-09-01T06:00:00Z' and '2026-09-01 06:00:00' are different instants and give different answers.
name	string	required
day	integer	optional	Day of the month as a number, 1-31.
house_number	string	optional	House or Apartment Number. Required only if 'house_number' is included in 'keys'.
keys	array	optional	Which calculations to return, as a list of names. See the key table for this endpoint; an unrecognised name rejects the whole request. One call costs one credit however many keys you ask for, so request everything you need at once rather than making several calls.
month	integer	optional	Month of birth as a number, 1-12. January is 1.
phone_number	string	optional	Full Phone Number. Required only if 'phone_number' is included in 'keys'.
system	string	optional
year	integer	optional	Year of birth as a number, e.g. 1990. Four digits.

Example request

curl -X POST https://yogataraapi.prahlad.app/api/astro/numerology/vedic/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-08-15T10:30:00+05:30","name":"Ajeet Kumar","day":15,"month":8,"year":1990}'

Response

{
  "data": {
    "bhagyank": 6,
    "moolank": 6,
    "namank": 4,
    "vedic_grid": {
      "grid": [
        [
          0,
          2,
          0
        ],
        [
          0,
          1,
          0
        ],
        [
          1,
          2,
          0
        ]
      ],
      "grid_layout": [
        [
          4,
          9,
          2
        ],
        [
          3,
          5,
          7
        ],
        [
          8,
          1,
          6
        ]
      ],
      "details": {
        "1": {
          "planet": "Sun (Surya)",
          "meaning": "Leadership, authority, soul, father",
          "count": 2,
          "active": true
        },
        "2": {
          "planet": "Moon (Chandra)",
          "meaning": "Mind, emotions, mother, intuition",
          "count": 0,
          "active": false
        },
        "3": {
          "planet": "Jupiter (Guru)",
          "meaning": "Wisdom, knowledge, expansion, teacher",
          "count": 0,
          "active": false
        },
        "4": {
          "planet": "Rahu (North Node)",
          "meaning": "Illusion, material desires, sudden changes",
          "count": 0,
          "active": false
        },
        "5": {
          "planet": "Mercury (Buddh)",
          "meaning": "Communication, intellect, business, speech",
          "count": 1,
          "active": true
        },
        "6": {
          "planet": "Venus (Shukra)",
          "meaning": "Love, luxury, arts, relationships",
          "count": 0,
          "active": false
        },
        "7": {
          "planet": "Ketu (South Node)",
          "meaning": "Spirituality, detachment, intuition, moksha",
          "count": 0,
          "active": false
        },
        "8": {
          "planet": "Saturn (Shani)",
          "meaning": "Discipline, karma, hard work, delays",
          "count": 1,
          "active": true
        },
        "9": {
          "planet": "Mars (Mangal)",
          "meaning": "Energy, courage, action, aggression",
          "count": 2,
          "active": true
        }
      }
    },
    "vedic_personal_day": 2,
    "vedic_personal_month": 5,
    "vedic_personal_year": 6
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Captured from a real call using the exact request above. Results sit under data.

Errors

Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.