POSThttps://api.occultapi.com/api/astro/numerology/

Нумерологія

Тіло запитуJSON

Щоб надіслати запит, вставте API-ключ вище.

Фрагмент коду

curl -X POST https://api.occultapi.com/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"]}'

Нумерологія зводить ім’я та дату народження до однозначних чисел і тлумачить їх. Цей ендпоінт підтримує чотири системи, які обирають через system, і в кожної — власна таблиця літер і власний набір доступних ключів. 'chaldean' (за замовчуванням) і 'pythagorean' — західна пара з шістнадцятьма спільними ключами: життєвий шлях, вираження, душа, особистість тощо. Вони відрізняються значеннями літер і ще однією важливою особливістю: піфагорійська система зберігає майстер-числа 11 і 22, а халдейська завжди зводить до однієї цифри, тож expression_number, soul_urge_number, maturity_number і life_path_number можуть дорівнювати 11 або 22 лише в піфагорійській. Піфагорійська має ще три власні ключі: pinnacle_cycles, balance_number і rational_thought. 'chinese' і 'vedic' — окремі набори, що не перетинаються, крім personal_year_number, який підтримує й китайська система. Якщо запитати ключ, якого немає в обраній системі, запит буде відхилено з HTTP 400 і назвою цього ключа. У кожному виклику надсилайте date_time і name. year, month і day — цільова дата для ключів особистого року, місяця й дня; за замовчуванням — сьогоднішня; house_number і phone_number обов’язкові, лише коли запитано відповідні ключі. Поряд із результатом кожного ключа відповідь містить об’єкт <key>_metadata із вхідними даними, формулою й значенням цього ключа, а також vedic_planet_associations або, для китайської системи, chinese_number_meanings.

Поля запиту

Поле	Тип	Обов’язкове	Примітки
date_time	string (date-time)	обов’язковий	Момент, для якого виконується розрахунок, у форматі ISO 8601. ЗАВЖДИ вказуйте зміщення або Z у кінці: значення без часового поясу читається як Asia/Kolkata (UTC+05:30), а не UTC, і може повернути результат за попередній день із кодом 200. '2026-09-01T06:00:00Z' і '2026-09-01 06:00:00' — різні моменти, і відповіді для них різні.
keys	array	обов’язковий	Які розрахунки повернути, у вигляді списку назв. Див. таблицю ключів цього ендпоінта; через нерозпізнану назву відхиляється весь запит. Один виклик коштує один кредит незалежно від кількості запитаних ключів, тож запитуйте все потрібне одразу, а не кількома викликами. Доступні ключі залежать від `system`. Халдейська й піфагорійська системи мають шістнадцять спільних ключів; піфагорійська додає pinnacle_cycles, balance_number і rational_thought; китайська й ведична мають власні набори й інших не приймають. Ключ, якого немає в обраній системі, повертає 400 із назвою цього ключа.
name	string	обов’язковий
day	integer	необов’язковий	День місяця числом, 1-31.
house_number	string	необов’язковий	Номер будинку або квартири. Обов’язкове, лише якщо 'house_number' є в 'keys'.
month	integer	необов’язковий	Місяць народження числом від 1 до 12; січень — 1.
phone_number	string	необов’язковий	Повний номер телефону. Обов’язкове, лише якщо 'phone_number' є в 'keys'.
system	string	необов’язковий	Яку нумерологічну систему використовувати. Підтримуються халдейська, піфагорійська, китайська та ведична системи. `chaldeanpythagoreanchinesevedic`
year	integer	необов’язковий	Рік народження числом, напр. 1990. Чотири цифри.

Доступні ключі (34)

Перелічіть у keys саме ті розрахунки, які вам потрібні. Один невідомий ключ — і відхиляється весь запит. Скільки б ключів ви не запитали, спишеться 1 кредит, тож збирайте їх в один виклик.

Ключ	Додаткові поля	Опис
balance_number	—	Перші літери кожного слова імені, переведені в числа, підсумовані й зведені, — ресурс, на який людина спирається в стресовій ситуації. Одне ціле число 1-9. Лише піфагорійська система.
bhagyank	—	Ведичне число долі: усі вісім цифр дати народження у форматі DDMMYYYY, додані й зведені. Одне ціле число 1-9. Лише ведична система.
birthday_number	—	Повертає те саме значення, що й psychic_number, — день народження, зведений до однієї цифри, одне ціле число 1-9. Зверніть увагу: це відрізняється від поширеної конвенції, за якою число дня народження — незведений день, 1-31. Доступно, коли `system` має значення `chaldean`, `pythagorean`; для інших систем повертається 400.
bridge_number	—	Розрив між тим, хто ви є, і тим, що ви робите: абсолютна різниця між зведеним числом життєвого шляху і зведеним числом вираження. Одне ціле число 0-8, де менше значення означає, що вони ближчі одне до одного. Доступно, коли `system` має значення `chaldean`, `pythagorean`; для інших систем повертається 400.
challenge_number	—	Абсолютна різниця між зведеним місяцем народження і зведеним днем народження. Одне ціле число 0-8. Зверніть увагу: повертається одне число, а не набір із чотирьох чисел випробування, який дають деякі системи. Доступно, коли `system` має значення `chaldean`, `pythagorean`; для інших систем повертається 400.
chinese_name_number	—	Ім’я, оцінене за таблицею звуків піньїнь, а не за західною таблицею літер, а потім зведене. Китайські ієрогліфи шукають у невеликій таблиці прізвищ (для ієрогліфів, яких там немає, є резервне значення), а для латинських літер використовується таблиця відповідностей піньїнь. Одне ціле число 1-9. Лише китайська система.
compound_meaning	—	Класична назва складеного числа з таблиці від 10 до 52 — 'The Wheel of Fortune', 'The Star of the Magi', 'The Crown of the Magi' тощо. Один рядок або 'No specific meaning defined', коли складена сума виходить за межі 10-52, що часто трапляється з довшими іменами. Доступно, коли `system` має значення `chaldean`, `pythagorean`; для інших систем повертається 400.
compound_number	—	Незведена сума всіх літер повного імені за таблицею обраної системи — число, яке шукає compound_meaning. Одне ціле число, зазвичай десь від двадцяти до двохсот залежно від довжини імені. Доступно, коли `system` має значення `chaldean`, `pythagorean`; для інших систем повертається 400.
expression_number	—	Число долі: кожна літера повного імені, переведена в число за таблицею літер обраної системи, підсумована й зведена. Одне ціле число — завжди 1-9 у халдейській системі, а в піфагорійській, яка зберігає майстер-числа, — 1-9 або 11 чи 22. Доступно, коли `system` має значення `chaldean`, `pythagorean`; для інших систем повертається 400.
five_element_balance	—	Як цифри дати народження, число життєвого шляху та китайське число імені розподіляються між п’ятьма елементами. Повертає {balance, interpretation}, де ключами balance є Wood, Fire, Earth, Metal і Water, а кожен запис — {count, percentage, meaning, associated_numbers}. Дереву відповідають 3 і 4, Вогню — 9, Землі — 2, 5 і 8, Металу — 6 і 7, Воді — 1; нулі ніде не враховуються. Лише китайська система.
growth_number	—	Сума дня й місяця народження, зведена до однієї цифри. Одне ціле число 1-9. Доступно, коли `system` має значення `chaldean`, `pythagorean`; для інших систем повертається 400.
hidden_passion_number	—	Значення літери, що найчастіше трапляється в повному імені, — талант, на який ім’я вказує знову й знову. Одне ціле число; якщо кілька значень трапляються однаково часто, повертається найменше, а якщо в імені немає літер із числовим значенням — 0. Доступно, коли `system` має значення `chaldean`, `pythagorean`; для інших систем повертається 400.
house_number	house_number	Цифри номера будинку або квартири, переданого в полі house_number, додані й зведені до однієї цифри. Одне ціле число 1-9 або 0, якщо значення не містить цифр. Лише китайська система; поле запиту обов’язкове щоразу, коли запитано цей ключ.
karmic_debt_numbers	—	Значення літер, які жодного разу не трапляються в повному імені, — те, що більшість систем називає кармічними уроками, а не кармічними боргами. Повертає список відсутніх значень у межах 1-8 у халдейській системі (у її таблиці немає 9) і 1-9 у піфагорійській. Класичні числа боргу 13/14/16/19 не повертає. Доступно, коли `system` має значення `chaldean`, `pythagorean`; для інших систем повертається 400.
life_path_number	—	День, місяць і рік народження зводять кожен окремо, додають і знову зводять. Одне ціле число; у піфагорійській системі 11 і 22 зберігаються. Порівняйте з personal_life_path_number і bhagyank: вони натомість підсумовують необроблені цифри дати й можуть дати іншу відповідь. Доступно, коли `system` має значення `chaldean`, `pythagorean`; для інших систем повертається 400.
loshu_grid_arrows	—	Чотири стрілки Ло Шу: для кожної перевіряють, чи містить дата народження всі три цифри її лінії. Повертає об’єкт із ключами arrow_of_determination (1-5-9), arrow_of_emotional_balance (2-5-8), arrow_of_practicality (1-4-7) і arrow_of_intellect (3-6-9), кожен — {present, meaning}. Повідомляється лише наявність стрілки; порожні стрілки окремим результатом не вважаються. Лише китайська система.
lucky_numbers	—	Щасливі числа тварини китайського зодіаку за роком народження, доповнені загальносприятливими 8, 6 і 9. Повертає відсортований список різних цілих чисел, зазвичай від чотирьох до шести. Лише китайська система.
maturity_number	—	Число вираження, додане до числа життєвого шляху і зведене. Одне ціле число; у піфагорійській системі 11 і 22 зберігаються. Доступно, коли `system` має значення `chaldean`, `pythagorean`; для інших систем повертається 400.
moolank	—	Ведичне психічне число: день народження, зведений до однієї цифри. Одне ціле число 1-9. Лише ведична система; за значенням ідентичне psychic_number.
namank	—	Ведичне число імені: повне ім’я, оцінене за халдейською таблицею літер і зведене. Одне ціле число 1-9. Лише ведична система; таблиця завжди халдейська, хоч би що було вказано.
name_number	—	Лише ім’я — усе до першого пробілу, — переведене в числа за обраною таблицею літер, підсумоване й зведене. Одне ціле число 1-9; майстер-числа тут не зберігаються навіть у піфагорійській системі. Доступно, коли `system` має значення `chaldean`, `pythagorean`; для інших систем повертається 400.
personal_life_path_number	—	Усі цифри дати народження у форматі DDMMYYYY, додані й зведені до однієї цифри. Одне ціле число 1-9. Лише китайська система; ведичний ключ bhagyank обчислює ідентичне значення.
personal_year_number	year	Тема заданого календарного року: день народження, місяць народження і цільовий рік спершу зводять кожен окремо, а потім додають і знову зводять. Приймає year, за замовчуванням — поточний рік. Одне ціле число 1-9; це єдиний ключ, доступний у всіх системах.
personality_number	—	Приголосні повного імені, підсумовані й зведені, — зовнішнє враження, на відміну від внутрішнього, яке описує soul_urge_number. Одне ціле число 1-9, ніколи не майстер-число. Доступно, коли `system` має значення `chaldean`, `pythagorean`; для інших систем повертається 400.
phone_number	phone_number	Цифри номера телефону, переданого в полі phone_number, додані й зведені. Одне ціле число 1-9 або 0, якщо цифр немає. Лише китайська система; поле обов’язкове щоразу, коли запитано цей ключ.
pinnacle_cycles	—	Чотири вершини — послідовні життєві фази піфагорійської нумерології, побудовані зі зведених місяця, дня й року народження. Повертає {first, second, third, fourth}, кожне — ціле число, де 11 і 22 зберігаються. Лише піфагорійська система.
psychic_number	—	Кореневе, або психічне, число: день місяця народження, зведений до однієї цифри. Одне ціле число 1-9. Лише халдейська й піфагорійська системи.
rational_thought	—	Сума літер імені плюс день народження, зведена; за нею судять, як людина продумує проблему. Одне ціле число 1-9. Лише піфагорійська система.
soul_urge_number	—	Число бажання серця: лише голосні повного імені, підсумовані й зведені. Одне ціле число; у піфагорійській системі 11 і 22 зберігаються. Враховуються A, E, I, O та U; Y — ні. Доступно, коли `system` має значення `chaldean`, `pythagorean`; для інших систем повертається 400.
unlucky_numbers	—	Нещасливі числа тієї самої тварини зодіаку, об’єднані з 4. Повертає відсортований список різних цілих чисел. Лише китайська система.
vedic_grid	—	Сітка народження 3×3 з планетами-управителями. Повертає {grid, grid_layout, details}: grid_layout — фіксоване розташування [[4,9,2],[3,5,7],[8,1,6]], grid містить, скільки разів кожна з цих цифр трапляється в даті народження, у тих самих позиціях, а details має ключі від '1' до '9' зі значеннями {planet, meaning, count, active}. Лише ведична система.
vedic_personal_day	year, month, day	Особистий день: ((ведичний особистий місяць + цільовий день − 1) mod 9) + 1. Приймає year, month і day; за замовчуванням — сьогоднішня дата. Одне ціле число 1-9. Лише ведична система.
vedic_personal_month	year, month	Особистий місяць: ((ведичний особистий рік + цільовий місяць − 1) mod 9) + 1. Приймає year і month; за замовчуванням — сьогоднішня дата. Одне ціле число 1-9. Лише ведична система.
vedic_personal_year	year	Особистий рік за ведичною формулою ((день народження + місяць народження + цільовий рік − 1) mod 9) + 1. Зверніть увагу: тут додаються необроблені значення, без попереднього зведення, тож для тієї самої людини й року результат може відрізнятися від personal_year_number. Приймає year, за замовчуванням — поточний рік. Одне ціле число 1-9. Лише ведична система.

Повний довідник цього ендпоінта