POSThttps://yogataraapi.prahlad.app/api/astro/numerology/

Numerology

Request bodyJSON

Paste an API key above to send.

Code snippet

curl -X POST https://yogataraapi.prahlad.app/api/astro/numerology/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2026-09-01T06:00:00+05:30","name":"Ramesh Kumar","day":1,"month":9,"year":2026,"system":"chaldean","keys":["birthday_number","expression_number","life_path_number"]}'

Numerology reduces a name and a birth date to single digits and reads them. This endpoint implements four systems, chosen with system, and each has its own letter table and its own set of available keys. 'chaldean' (the default) and 'pythagorean' are the Western pair and share sixteen keys — life path, expression, soul urge, personality and the rest. They differ in the letter values used and in one behaviour worth knowing: Pythagorean preserves the master numbers 11 and 22 where Chaldean always reduces to a single digit, so expression_number, soul_urge_number, maturity_number and life_path_number can come back as 11 or 22 under Pythagorean only. Pythagorean adds three keys of its own: pinnacle_cycles, balance_number and rational_thought. 'chinese' and 'vedic' are separate sets with no overlap except personal_year_number, which Chinese also allows. Asking for a key outside the chosen system is rejected with HTTP 400 naming the offending key. Send date_time and name on every call. year, month and day are the target date for the personal-year, month and day keys and default to today's; house_number and phone_number are required only when those keys are requested. Alongside each key's result the response carries a <key>_metadata object giving that key's input, formula and meaning, and either vedic_planet_associations or, for the Chinese system, chinese_number_meanings.

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.
keys	array	required	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. Which keys are available depends on `system`. Chaldean and Pythagorean share sixteen keys; Pythagorean adds pinnacle_cycles, balance_number and rational_thought; Chinese and Vedic have their own sets and accept no others. Asking for a key outside the chosen system returns 400 naming the offending key.
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'.
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	The numerological system to use. Note: Chaldean, Pythagorean, Chinese, and Vedic systems are supported. `chaldeanpythagoreanchinesevedic`
year	integer	optional	Year of birth as a number, e.g. 1990. Four digits.

Available keys (34)

Ask for exactly the calculations you want by listing them in keys. An unknown key rejects the whole request, and you are charged 1 credit however many you ask for — so batch them.

Key	Extra fields needed	Description
balance_number	—	The initial letter of each word of the name, converted and summed, then reduced — the resource to fall back on under stress. A single integer 1-9. Pythagorean system only.
bhagyank	—	The Vedic destiny number: all eight digits of the birth date written DDMMYYYY, added and reduced. A single integer 1-9. Vedic system only.
birthday_number	—	Returns the same value as psychic_number — the day of birth reduced to a single digit, a single integer 1-9. Note this differs from the common convention in which the birthday number is the unreduced day, 1-31. Available when `system` is `chaldean`, `pythagorean`; the others return 400.
bridge_number	—	The gap between who you are and what you do: the absolute difference between the reduced life path number and the reduced expression number. A single integer 0-8, where a smaller value means the two sit closer together. Available when `system` is `chaldean`, `pythagorean`; the others return 400.
challenge_number	—	The absolute difference between the reduced birth month and the reduced birth day. A single integer 0-8. Note this returns one number, not the set of four challenge numbers some systems produce. Available when `system` is `chaldean`, `pythagorean`; the others return 400.
chinese_name_number	—	The name scored on a pinyin-sound table rather than a Western letter table, then reduced. Chinese characters are looked up in a small surname table (with a fallback value for characters not listed) and Latin letters use the pinyin map. A single integer 1-9. Chinese system only.
compound_meaning	—	The classical name of the compound number, from a table covering 10 to 52 — 'The Wheel of Fortune', 'The Star of the Magi', 'The Crown of the Magi' and so on. A single string, or 'No specific meaning defined' when the compound total falls outside 10-52, which is common for longer names. Available when `system` is `chaldean`, `pythagorean`; the others return 400.
compound_number	—	The unreduced total of every letter in the full name under the chosen system's table — the number compound_meaning looks up. A single integer, typically somewhere between twenty and two hundred depending on the length of the name. Available when `system` is `chaldean`, `pythagorean`; the others return 400.
expression_number	—	The destiny number: every letter of the full name converted with the chosen system's letter table, summed and reduced. A single integer — always 1-9 under Chaldean, and 1-9 or the master numbers 11 or 22 under Pythagorean, which preserves them. Available when `system` is `chaldean`, `pythagorean`; the others return 400.
five_element_balance	—	How the digits of the birth date, the life path number and the Chinese name number distribute across the five elements. Returns {balance, interpretation}, where balance is keyed Wood, Fire, Earth, Metal and Water and each entry is {count, percentage, meaning, associated_numbers}. Wood takes 3 and 4, Fire 9, Earth 2, 5 and 8, Metal 6 and 7, Water 1; zeros are not counted anywhere. Chinese system only.
growth_number	—	The birth day added to the birth month and reduced. A single integer 1-9. Available when `system` is `chaldean`, `pythagorean`; the others return 400.
hidden_passion_number	—	The letter value that occurs most often in the full name — the talent the name keeps repeating. A single integer; where several values tie for most frequent the smallest is returned, and 0 if the name contains no scoreable letters. Available when `system` is `chaldean`, `pythagorean`; the others return 400.
house_number	house_number	The digits of the house or flat number passed in the house_number field, added and reduced to a single digit. A single integer 1-9, or 0 if the value contains no digits. Chinese system only, and the request field is required whenever this key is asked for.
karmic_debt_numbers	—	The letter values that never occur in the full name — what most systems call karmic lessons rather than karmic debts. Returns a list of the missing values, drawn from 1-8 under Chaldean (whose table has no 9) and from 1-9 under Pythagorean. It does not return the classical 13/14/16/19 debt numbers. Available when `system` is `chaldean`, `pythagorean`; the others return 400.
life_path_number	—	The birth day, month and year each reduced, added, and reduced again. A single integer, preserving 11 and 22 under Pythagorean. Compare personal_life_path_number and bhagyank, which sum the raw digits of the date instead and can give a different answer. Available when `system` is `chaldean`, `pythagorean`; the others return 400.
loshu_grid_arrows	—	The four Lo Shu arrows, tested by checking whether the birth date contains all three digits of each line. Returns an object keyed arrow_of_determination (1-5-9), arrow_of_emotional_balance (2-5-8), arrow_of_practicality (1-4-7) and arrow_of_intellect (3-6-9), each {present, meaning}. Only presence is reported; empty arrows are not treated as a separate finding. Chinese system only.
lucky_numbers	—	The lucky numbers of the Chinese zodiac animal for the birth year, merged with the generally auspicious 8, 6 and 9. Returns a sorted list of distinct integers, usually four to six of them. Chinese system only.
maturity_number	—	The expression number added to the life path number and reduced. A single integer, preserving 11 and 22 under Pythagorean. Available when `system` is `chaldean`, `pythagorean`; the others return 400.
moolank	—	The Vedic psychic number: the day of birth reduced to a single digit. A single integer 1-9. Vedic system only, and identical in value to psychic_number.
namank	—	The Vedic name number: the full name scored on the Chaldean letter table and reduced. A single integer 1-9. Vedic system only, and it always uses the Chaldean table regardless of anything else.
name_number	—	The first name only — everything up to the first space — converted with the chosen letter table, summed and reduced. A single integer 1-9; master numbers are not preserved here even under Pythagorean. Available when `system` is `chaldean`, `pythagorean`; the others return 400.
personal_life_path_number	—	Every digit of the birth date written as DDMMYYYY, added and reduced to a single digit. A single integer 1-9. Chinese system only; the Vedic key bhagyank computes the identical value.
personal_year_number	year	The theme of a given calendar year: the birth day, the birth month and the target year each reduced first, then added and reduced again. Takes year, defaulting to the current year. A single integer 1-9, and the only key available in every system.
personality_number	—	The consonants of the full name summed and reduced — the outward impression, as against soul_urge_number's inner one. A single integer 1-9, never a master number. Available when `system` is `chaldean`, `pythagorean`; the others return 400.
phone_number	phone_number	The digits of the phone number passed in the phone_number field, added and reduced. A single integer 1-9, or 0 if there are no digits. Chinese system only, and the field is required whenever this key is asked for.
pinnacle_cycles	—	The four pinnacles, the successive life phases of Pythagorean numerology, built from the reduced birth month, day and year. Returns {first, second, third, fourth}, each an integer with 11 and 22 preserved. Pythagorean system only.
psychic_number	—	The root or psychic number: the day of the month of birth reduced to a single digit. A single integer 1-9. Chaldean and Pythagorean systems only.
rational_thought	—	The first name's letter sum plus the day of birth, reduced — read as how the person thinks a problem through. A single integer 1-9. Pythagorean system only.
soul_urge_number	—	The heart's desire number: only the vowels of the full name, summed and reduced. A single integer, preserving 11 and 22 under Pythagorean. A, E, I, O and U count; Y does not. Available when `system` is `chaldean`, `pythagorean`; the others return 400.
unlucky_numbers	—	The unlucky numbers of that same zodiac animal, merged with 4. Returns a sorted list of distinct integers. Chinese system only.
vedic_grid	—	The 3×3 birth grid with its planetary rulers. Returns {grid, grid_layout, details}: grid_layout is the fixed [[4,9,2],[3,5,7],[8,1,6]] arrangement, grid holds how many times each of those digits occurs in the birth date in the same positions, and details is keyed '1' to '9' with {planet, meaning, count, active}. Vedic system only.
vedic_personal_day	year, month, day	The personal day: ((vedic personal month + target day − 1) mod 9) + 1. Takes year, month and day, each defaulting to today's. A single integer 1-9. Vedic system only.
vedic_personal_month	year, month	The personal month: ((vedic personal year + target month − 1) mod 9) + 1. Takes year and month, each defaulting to today's. A single integer 1-9. Vedic system only.
vedic_personal_year	year	The personal year on the Vedic formula ((birth day + birth month + target year − 1) mod 9) + 1. Note it adds the raw values rather than reducing each first, so it can differ from personal_year_number for the same person and year. Takes year, defaulting to the current year. A single integer 1-9. Vedic system only.

Full reference for this endpoint