POST/api/astro/numerology/1 crédit

Numérologie

La numérologie ramène un nom et une date de naissance à des nombres d’un seul chiffre et les interprète. Cet endpoint met en œuvre quatre systèmes, au choix via system, chacun avec sa propre table des lettres et son propre ensemble de clés disponibles. 'chaldean' (par défaut) et 'pythagorean' forment la paire occidentale et partagent seize clés — chemin de vie, nombre d’expression, nombre intime, nombre de personnalité, etc. Ils diffèrent par les valeurs attribuées aux lettres et sur un point à connaître : le système pythagoricien conserve les nombres maîtres 11 et 22, alors que le chaldéen réduit toujours à un seul chiffre ; expression_number, soul_urge_number, maturity_number et life_path_number ne peuvent donc valoir 11 ou 22 qu’en pythagoricien. Le système pythagoricien ajoute trois clés qui lui sont propres : pinnacle_cycles, balance_number et rational_thought. 'chinese' et 'vedic' sont des ensembles distincts, sans clé commune hormis personal_year_number, que le système chinois accepte aussi. Une clé extérieure au système choisi est rejetée avec une erreur HTTP 400 qui nomme la clé fautive. Envoyez date_time et name à chaque appel. year, month et day sont la date cible des clés d’année, de mois et de jour personnels et valent par défaut la date du jour ; house_number et phone_number ne sont obligatoires que si ces clés sont demandées. En plus du résultat de chaque clé, la réponse contient un objet <key>_metadata qui en donne l’entrée, la formule et la signification, ainsi que vedic_planet_associations ou, pour le système chinois, chinese_number_meanings.

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

Tester la requête

Authentification

Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.

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

Champs de la requête

Champ	Type	Obligatoire	Remarques
date_time	string (date-time)	obligatoire	Le moment du calcul, en ISO 8601. Incluez TOUJOURS un décalage ou un Z final - une valeur sans fuseau est lue comme Asia/Kolkata (UTC+05:30), et non comme UTC, et peut renvoyer le résultat de la veille avec un statut 200. '2026-09-01T06:00:00Z' et '2026-09-01 06:00:00' sont des instants différents et donnent des réponses différentes.
keys	array	obligatoire	Les calculs à renvoyer, sous forme de liste de noms. Consultez le tableau des clés de cet endpoint ; un nom non reconnu fait rejeter toute la requête. Un appel coûte un crédit quel que soit le nombre de clés demandées : demandez donc tout ce dont vous avez besoin en une seule fois plutôt que de faire plusieurs appels. Les clés disponibles dépendent de `system`. Les systèmes chaldéen et pythagoricien partagent seize clés ; le pythagoricien ajoute pinnacle_cycles, balance_number et rational_thought ; les systèmes chinois et védique ont leurs propres ensembles et n’acceptent aucune autre clé. Une clé extérieure au système choisi renvoie une erreur 400 qui nomme la clé fautive.
name	string	obligatoire
day	integer	facultatif	Jour du mois sous forme de nombre, 1-31.
house_number	string	facultatif	Numéro de maison ou d’appartement. Obligatoire uniquement si 'house_number' figure dans 'keys'.
month	integer	facultatif	Mois de naissance sous forme de nombre, 1-12. Janvier vaut 1.
phone_number	string	facultatif	Numéro de téléphone complet. Obligatoire uniquement si 'phone_number' figure dans 'keys'.
system	string	facultatif	Le système numérologique à utiliser. Remarque : les systèmes chaldéen, pythagoricien, chinois et védique sont pris en charge. `chaldeanpythagoreanchinesevedic`
year	integer	facultatif	Année de naissance sous forme de nombre, p. ex. 1990. Quatre chiffres.

Clés disponibles (34)

Listez dans keys exactement les calculs voulus. Une clé inconnue fait rejeter toute la requête. Vous payez 1 crédit, quel que soit le nombre de clés demandées : regroupez-les donc.

Clé	Champs supplémentaires requis	Description
balance_number	—	L’initiale de chaque mot du nom, convertie et additionnée, puis réduite — la ressource sur laquelle se rabattre en situation de stress. Un seul entier, 1-9. Système pythagoricien uniquement.
bhagyank	—	Le nombre de destinée védique : les huit chiffres de la date de naissance écrite DDMMYYYY, additionnés et réduits. Un seul entier, 1-9. Système védique uniquement.
birthday_number	—	Renvoie la même valeur que psychic_number — le jour de naissance réduit à un seul chiffre, soit un seul entier, 1-9. Attention : cela diffère de la convention courante, où le nombre du jour de naissance est le jour non réduit, 1-31. Disponible lorsque `system` vaut `chaldean` ou `pythagorean` ; les autres renvoient une erreur 400.
bridge_number	—	L’écart entre ce que vous êtes et ce que vous faites : la différence absolue entre le chemin de vie réduit et le nombre d’expression réduit. Un seul entier, 0-8 ; plus la valeur est petite, plus les deux sont proches. Disponible lorsque `system` vaut `chaldean` ou `pythagorean` ; les autres renvoient une erreur 400.
challenge_number	—	La différence absolue entre le mois de naissance réduit et le jour de naissance réduit. Un seul entier, 0-8. Notez que cette clé renvoie un seul nombre, et non l’ensemble des quatre nombres de défi que produisent certains systèmes. Disponible lorsque `system` vaut `chaldean` ou `pythagorean` ; les autres renvoient une erreur 400.
chinese_name_number	—	La valeur du nom calculée sur une table des sons du pinyin plutôt que sur une table des lettres occidentale, puis réduite. Les caractères chinois sont cherchés dans une petite table de noms de famille (avec une valeur de repli pour les caractères absents) et les lettres latines passent par la correspondance pinyin. Un seul entier, 1-9. Système chinois uniquement.
compound_meaning	—	Le nom classique du nombre composé, tiré d’une table couvrant 10 à 52 — 'The Wheel of Fortune', 'The Star of the Magi', 'The Crown of the Magi', etc. Une seule chaîne, ou 'No specific meaning defined' lorsque le total composé sort de 10-52, ce qui est fréquent pour les noms longs. Disponible lorsque `system` vaut `chaldean` ou `pythagorean` ; les autres renvoient une erreur 400.
compound_number	—	Le total non réduit de toutes les lettres du nom complet selon la table du système choisi — le nombre que recherche compound_meaning. Un seul entier, généralement compris entre vingt et deux cents selon la longueur du nom. Disponible lorsque `system` vaut `chaldean` ou `pythagorean` ; les autres renvoient une erreur 400.
expression_number	—	Le nombre de destinée : toutes les lettres du nom complet, converties avec la table des lettres du système choisi, additionnées puis réduites. Un seul entier — toujours 1-9 en chaldéen ; 1-9 ou les nombres maîtres 11 ou 22 en pythagoricien, qui les conserve. Disponible lorsque `system` vaut `chaldean` ou `pythagorean` ; les autres renvoient une erreur 400.
five_element_balance	—	La répartition des chiffres de la date de naissance, du chemin de vie et du nombre du nom chinois entre les cinq éléments. Renvoie {balance, interpretation}, où balance a les clés Wood, Fire, Earth, Metal et Water et chaque entrée est {count, percentage, meaning, associated_numbers}. Le Bois prend 3 et 4, le Feu 9, la Terre 2, 5 et 8, le Métal 6 et 7, l’Eau 1 ; les zéros ne sont comptés nulle part. Système chinois uniquement.
growth_number	—	Le jour de naissance ajouté au mois de naissance, puis réduit. Un seul entier, 1-9. Disponible lorsque `system` vaut `chaldean` ou `pythagorean` ; les autres renvoient une erreur 400.
hidden_passion_number	—	La valeur de lettre la plus fréquente dans le nom complet — le talent que le nom ne cesse de répéter. Un seul entier ; en cas d’égalité entre plusieurs valeurs, la plus petite est renvoyée, et 0 si le nom ne contient aucune lettre comptabilisable. Disponible lorsque `system` vaut `chaldean` ou `pythagorean` ; les autres renvoient une erreur 400.
house_number	house_number	Les chiffres du numéro de maison ou d’appartement passé dans le champ house_number, additionnés et réduits à un seul chiffre. Un seul entier, 1-9, ou 0 si la valeur ne contient aucun chiffre. Système chinois uniquement, et le champ de la requête est obligatoire dès que cette clé est demandée.
karmic_debt_numbers	—	Les valeurs de lettres qui n’apparaissent jamais dans le nom complet — ce que la plupart des systèmes appellent leçons karmiques, et non dettes karmiques. Renvoie la liste des valeurs manquantes, prises dans 1-8 en chaldéen (dont la table n’a pas de 9) et dans 1-9 en pythagoricien. Ne renvoie pas les nombres de dette classiques 13/14/16/19. Disponible lorsque `system` vaut `chaldean` ou `pythagorean` ; les autres renvoient une erreur 400.
life_path_number	—	Le jour, le mois et l’année de naissance, réduits chacun, additionnés, puis réduits à nouveau. Un seul entier, qui conserve 11 et 22 en pythagoricien. À comparer avec personal_life_path_number et bhagyank, qui additionnent directement les chiffres bruts de la date et peuvent donner un autre résultat. Disponible lorsque `system` vaut `chaldean` ou `pythagorean` ; les autres renvoient une erreur 400.
loshu_grid_arrows	—	Les quatre flèches du Lo Shu, détectées en vérifiant si la date de naissance contient les trois chiffres de chaque ligne. Renvoie un objet avec les clés arrow_of_determination (1-5-9), arrow_of_emotional_balance (2-5-8), arrow_of_practicality (1-4-7) et arrow_of_intellect (3-6-9), chacune de la forme {present, meaning}. Seule la présence est indiquée ; les flèches vides ne sont pas traitées comme un constat à part. Système chinois uniquement.
lucky_numbers	—	Les nombres porte-bonheur de l’animal du zodiaque chinois de l’année de naissance, auxquels s’ajoutent 8, 6 et 9, propices de manière générale. Renvoie une liste triée d’entiers distincts, en général quatre à six. Système chinois uniquement.
maturity_number	—	Le nombre d’expression ajouté au chemin de vie, puis réduit. Un seul entier, qui conserve 11 et 22 en pythagoricien. Disponible lorsque `system` vaut `chaldean` ou `pythagorean` ; les autres renvoient une erreur 400.
moolank	—	Le nombre psychique védique : le jour de naissance réduit à un seul chiffre. Un seul entier, 1-9. Système védique uniquement ; même valeur que psychic_number.
namank	—	Le nombre du nom en numérologie védique : le nom complet calculé sur la table des lettres chaldéenne, puis réduit. Un seul entier, 1-9. Système védique uniquement ; la table chaldéenne est toujours utilisée, quels que soient les autres paramètres.
name_number	—	Le prénom seul — tout ce qui précède la première espace — converti avec la table des lettres choisie, additionné et réduit. Un seul entier, 1-9 ; les nombres maîtres ne sont pas conservés ici, même en pythagoricien. Disponible lorsque `system` vaut `chaldean` ou `pythagorean` ; les autres renvoient une erreur 400.
personal_life_path_number	—	Tous les chiffres de la date de naissance écrite DDMMYYYY, additionnés et réduits à un seul chiffre. Un seul entier, 1-9. Système chinois uniquement ; la clé védique bhagyank calcule la même valeur.
personal_year_number	year	La tonalité d’une année civile donnée : le jour de naissance, le mois de naissance et l’année cible, réduits chacun d’abord, puis additionnés et réduits à nouveau. Prend year, qui vaut par défaut l’année en cours. Un seul entier, 1-9. C’est la seule clé disponible dans tous les systèmes.
personality_number	—	Les consonnes du nom complet additionnées et réduites — l’impression extérieure, par opposition à l’impression intérieure de soul_urge_number. Un seul entier, 1-9, jamais un nombre maître. Disponible lorsque `system` vaut `chaldean` ou `pythagorean` ; les autres renvoient une erreur 400.
phone_number	phone_number	Les chiffres du numéro de téléphone passé dans le champ phone_number, additionnés et réduits. Un seul entier, 1-9, ou 0 s’il n’y a aucun chiffre. Système chinois uniquement, et le champ est obligatoire dès que cette clé est demandée.
pinnacle_cycles	—	Les quatre pinacles, les phases de vie successives de la numérologie pythagoricienne, construits à partir du mois, du jour et de l’année de naissance réduits. Renvoie {first, second, third, fourth}, chacun un entier (11 et 22 sont conservés). Système pythagoricien uniquement.
psychic_number	—	Le nombre racine ou psychique : le jour du mois de naissance réduit à un seul chiffre. Un seul entier, 1-9. Systèmes chaldéen et pythagoricien uniquement.
rational_thought	—	La somme des lettres du prénom plus le jour de naissance, réduite — interprétée comme la façon dont la personne réfléchit à un problème. Un seul entier, 1-9. Système pythagoricien uniquement.
soul_urge_number	—	Le nombre du désir du cœur : seules les voyelles du nom complet, additionnées et réduites. Un seul entier, qui conserve 11 et 22 en pythagoricien. A, E, I, O et U comptent ; Y non. Disponible lorsque `system` vaut `chaldean` ou `pythagorean` ; les autres renvoient une erreur 400.
unlucky_numbers	—	Les nombres néfastes de ce même animal du zodiaque, auxquels s’ajoute 4. Renvoie une liste triée d’entiers distincts. Système chinois uniquement.
vedic_grid	—	La grille de naissance 3×3 avec ses planètes maîtresses. Renvoie {grid, grid_layout, details} : grid_layout est la disposition fixe [[4,9,2],[3,5,7],[8,1,6]], grid donne, aux mêmes positions, le nombre d’occurrences de chacun de ces chiffres dans la date de naissance, et details a les clés '1' à '9', chacune avec {planet, meaning, count, active}. Système védique uniquement.
vedic_personal_day	year, month, day	Le jour personnel : ((mois personnel védique + jour cible − 1) mod 9) + 1. Prend year, month et day, chacun valant par défaut la date du jour. Un seul entier, 1-9. Système védique uniquement.
vedic_personal_month	year, month	Le mois personnel : ((année personnelle védique + mois cible − 1) mod 9) + 1. Prend year et month, chacun valant par défaut la date du jour. Un seul entier, 1-9. Système védique uniquement.
vedic_personal_year	year	L’année personnelle selon la formule védique ((jour de naissance + mois de naissance + année cible − 1) mod 9) + 1. Notez qu’elle additionne les valeurs brutes au lieu de réduire chacune d’abord ; elle peut donc différer de personal_year_number pour la même personne et la même année. Prend year, qui vaut par défaut l’année en cours. Un seul entier, 1-9. Système védique uniquement.

Exemple de requête

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

Réponse

{
  "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"
}

Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data, sous le nom de chaque clé demandée.

Erreurs

Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.