POST/api/astro/numerology/chaldean/1 credit

Chaldean numerology

Chaldean numerology: the older Western system, and the one most Indian practitioners use for names. Letters score 1 to 8 — there is no 9, which is held sacred — and the values follow sound rather than alphabetical order, so the same name can differ from its Pythagorean value. Returns life path, expression, soul urge, personality, birthday, maturity and the compound numbers. Returns 16 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/chaldean/

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/chaldean/ \
  -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": {
    "birthday_number": 6,
    "bridge_number": 2,
    "challenge_number": 2,
    "compound_meaning": "The Recluse",
    "compound_number": 31,
    "expression_number": 4,
    "growth_number": 5,
    "hidden_passion_number": 1,
    "karmic_debt_numbers": [
      3,
      7,
      8
    ],
    "life_path_number": 6,
    "maturity_number": 1,
    "name_number": 7,
    "personal_year_number": 6,
    "personality_number": 4,
    "psychic_number": 6,
    "soul_urge_number": 9
  },
  "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.