POST/api/astro/numerology/1 кредит

Нумерологія

Нумерологія зводить ім’я та дату народження до однозначних чисел і тлумачить їх. Цей ендпоінт підтримує чотири системи, які обирають через 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.

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

Спробувати запит

Автентифікація

Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.

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

Поля запиту

Поле	Тип	Обов’язкове	Примітки
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. Лише ведична система.

Приклад запиту

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"]}'

Відповідь

{
  "data": {
    "birthday_number": 1,
    "expression_number": 8,
    "life_path_number": 2,
    "birthday_number_metadata": {
      "name": "Birthday Number",
      "input": "Day of Birth (DD)",
      "formula": "Use the day directly if it's a single digit; if it's a double-digit number, reduce to a single digit.",
      "meaning": "Reveals natural talents and key characteristics based on birthdate."
    },
    "expression_number_metadata": {
      "name": "Expression Number (Destiny Number)",
      "input": "Full Name (Chaldean letter chart)",
      "formula": "Sum the values of all letters based on Chaldean chart and reduce to a single digit.",
      "meaning": "Reflects overall potential and life path, linked to name vibration."
    },
    "vedic_planet_associations": {
      "1": {
        "planet": "Sun (Surya)",
        "meaning": "Leadership, authority, soul, father"
      },
      "2": {
        "planet": "Moon (Chandra)",
        "meaning": "Mind, emotions, mother, intuition"
      },
      "3": {
        "planet": "Jupiter (Guru)",
        "meaning": "Wisdom, knowledge, expansion, teacher"
      },
      "4": {
        "planet": "Rahu (North Node)",
        "meaning": "Illusion, material desires, sudden changes"
      },
      "5": {
        "planet": "Mercury (Buddh)",
        "meaning": "Communication, intellect, business, speech"
      },
      "6": {
        "planet": "Venus (Shukra)",
        "meaning": "Love, luxury, arts, relationships"
      },
      "7": {
        "planet": "Ketu (South Node)",
        "meaning": "Spirituality, detachment, intuition, moksha"
      },
      "8": {
        "planet": "Saturn (Shani)",
        "meaning": "Discipline, karma, hard work, delays"
      },
      "9": {
        "planet": "Mars (Mangal)",
        "meaning": "Energy, courage, action, aggression"
      }
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data під тими ключами, які ви запитали.

Помилки

Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.