POST/api/astro/numerology/1 Credit

Numerologie

Die Numerologie reduziert einen Namen und ein Geburtsdatum auf einzelne Ziffern und deutet sie. Dieser Endpoint bietet vier Systeme, die du mit system auswählst; jedes hat seine eigene Buchstabentabelle und seine eigenen Keys. 'chaldean' (Standard) und 'pythagorean' sind die beiden westlichen Systeme und teilen sich sechzehn Keys – Lebenszahl, Ausdruckszahl, Seelenzahl, Persönlichkeitszahl und die übrigen. Sie unterscheiden sich in den Buchstabenwerten und in einem Verhalten, das du kennen solltest: Pythagorean behält die Meisterzahlen 11 und 22, Chaldean reduziert dagegen immer auf eine einzelne Ziffer. expression_number, soul_urge_number, maturity_number und life_path_number können daher nur unter Pythagorean 11 oder 22 sein. Pythagorean hat außerdem drei eigene Keys: pinnacle_cycles, balance_number und rational_thought. 'chinese' und 'vedic' haben jeweils eigene Keys ohne Überschneidung; einzige Ausnahme ist personal_year_number, das auch im chinesischen System erlaubt ist. Ein Key außerhalb des gewählten Systems wird mit HTTP 400 abgelehnt, die Fehlermeldung nennt den betreffenden Key. Sende bei jedem Aufruf date_time und name. year, month und day sind das Zieldatum für die Keys zu persönlichem Jahr, Monat und Tag und standardmäßig auf heute gesetzt; house_number und phone_number sind nur nötig, wenn die gleichnamigen Keys angefordert werden. Neben dem Ergebnis jedes Keys enthält die Antwort ein Objekt <key>_metadata mit Eingabe, Formel und Bedeutung des Keys sowie entweder vedic_planet_associations oder, beim chinesischen System, chinese_number_meanings.

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

Anfrage testen

Authentifizierung

Schick deinen Schlüssel im Header X-API-Key mit. API-Schlüssel sind Zugangsdaten für den Server: Sie gehören nie in Browser-JavaScript oder in eine mobile App.

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

Felder der Anfrage

Feld	Typ	Pflicht	Hinweise
date_time	string (date-time)	Pflicht	Der Zeitpunkt, für den gerechnet wird, im Format ISO 8601. Gib IMMER einen Offset oder ein abschließendes Z an – ein Wert ohne Zone wird als Asia/Kolkata (UTC+05:30) gelesen, nicht als UTC, und kann mit Status 200 das Ergebnis des Vortags liefern. '2026-09-01T06:00:00Z' und '2026-09-01 06:00:00' sind verschiedene Zeitpunkte und ergeben verschiedene Antworten.
keys	array	Pflicht	Welche Berechnungen zurückgegeben werden, als Liste von Namen. Siehe die Key-Tabelle dieses Endpoints; ein unbekannter Name lässt die ganze Anfrage scheitern. Ein Aufruf kostet einen Credit, egal wie viele Keys du anforderst – fordere also alles, was du brauchst, auf einmal an, statt mehrere Aufrufe zu machen. Welche Keys verfügbar sind, hängt von `system` ab. Chaldean und Pythagorean teilen sich sechzehn Keys; Pythagorean hat zusätzlich pinnacle_cycles, balance_number und rational_thought; Chinese und Vedic haben eigene Keys und akzeptieren keine anderen. Ein Key außerhalb des gewählten Systems liefert 400 mit dem Namen des betreffenden Keys.
name	string	Pflicht
day	integer	optional	Tag des Monats als Zahl, 1-31.
house_number	string	optional	Haus- oder Wohnungsnummer. Nur erforderlich, wenn 'house_number' in 'keys' enthalten ist.
month	integer	optional	Geburtsmonat als Zahl, 1-12. Januar ist 1.
phone_number	string	optional	Vollständige Telefonnummer. Nur erforderlich, wenn 'phone_number' in 'keys' enthalten ist.
system	string	optional	Das zu verwendende numerologische System. Hinweis: Das chaldäische, pythagoreische, chinesische und vedische System werden unterstützt. `chaldeanpythagoreanchinesevedic`
year	integer	optional	Geburtsjahr als Zahl, z. B. 1990. Vier Ziffern.

Verfügbare Keys (34)

Liste in keys genau die Berechnungen auf, die du brauchst. Ein unbekannter Key lässt die ganze Anfrage scheitern. Du zahlst 1 Credit, ganz gleich, wie viele du anforderst – fass sie also in einer Anfrage zusammen.

Key	Zusätzliche Felder	Beschreibung
balance_number	—	Die Anfangsbuchstaben aller Wörter des Namens, umgerechnet, addiert und reduziert – die Kraft, auf die man unter Stress zurückgreift. Eine einzelne Ganzzahl 1-9. Nur im pythagoreischen System.
bhagyank	—	Die vedische Schicksalszahl: alle acht Ziffern des Geburtsdatums im Format DDMMYYYY, addiert und reduziert. Eine einzelne Ganzzahl 1-9. Nur im vedischen System.
birthday_number	—	Liefert denselben Wert wie psychic_number – den auf eine Ziffer reduzierten Geburtstag, eine einzelne Ganzzahl 1-9. Beachte: Nach der gängigen Konvention ist die Geburtstagszahl der unreduzierte Tag, 1-31; hier ist das anders. Verfügbar, wenn `system` `chaldean` oder `pythagorean` ist; die anderen liefern 400.
bridge_number	—	Der Abstand zwischen dem, wer du bist, und dem, was du tust: der Betrag der Differenz zwischen reduzierter Lebenszahl und reduzierter Ausdruckszahl. Eine einzelne Ganzzahl 0-8; je kleiner der Wert, desto näher liegen beide beieinander. Verfügbar, wenn `system` `chaldean` oder `pythagorean` ist; die anderen liefern 400.
challenge_number	—	Der Betrag der Differenz zwischen reduziertem Geburtsmonat und reduziertem Geburtstag. Eine einzelne Ganzzahl 0-8. Beachte: Geliefert wird eine einzige Zahl, nicht die vier Herausforderungszahlen, die manche Systeme berechnen. Verfügbar, wenn `system` `chaldean` oder `pythagorean` ist; die anderen liefern 400.
chinese_name_number	—	Der Name, bewertet nach einer Pinyin-Lauttabelle statt nach einer westlichen Buchstabentabelle und anschließend reduziert. Chinesische Schriftzeichen werden in einer kleinen Tabelle mit Familiennamen nachgeschlagen (mit einem Ersatzwert für nicht aufgeführte Zeichen), für lateinische Buchstaben gilt die Pinyin-Zuordnung. Eine einzelne Ganzzahl 1-9. Nur im chinesischen System.
compound_meaning	—	Der klassische Name der zusammengesetzten Zahl aus einer Tabelle für 10 bis 52 – 'The Wheel of Fortune', 'The Star of the Magi', 'The Crown of the Magi' und so weiter. Ein einzelner String oder 'No specific meaning defined', wenn die zusammengesetzte Summe außerhalb von 10-52 liegt, was bei längeren Namen häufig vorkommt. Verfügbar, wenn `system` `chaldean` oder `pythagorean` ist; die anderen liefern 400.
compound_number	—	Die unreduzierte Summe aller Buchstaben des vollständigen Namens nach der Tabelle des gewählten Systems – die Zahl, die compound_meaning nachschlägt. Eine einzelne Ganzzahl, je nach Länge des Namens meist irgendwo zwischen zwanzig und zweihundert. Verfügbar, wenn `system` `chaldean` oder `pythagorean` ist; die anderen liefern 400.
expression_number	—	Die Schicksalszahl: Jeder Buchstabe des vollständigen Namens wird mit der Buchstabentabelle des gewählten Systems umgerechnet, dann wird summiert und reduziert. Eine einzelne Ganzzahl – unter Chaldean immer 1-9, unter Pythagorean 1-9 oder eine der Meisterzahlen 11 und 22, die dort erhalten bleiben. Verfügbar, wenn `system` `chaldean` oder `pythagorean` ist; die anderen liefern 400.
five_element_balance	—	Wie sich die Ziffern des Geburtsdatums, die Lebenszahl und die chinesische Namenszahl auf die fünf Elemente verteilen. Liefert {balance, interpretation}; balance hat die Schlüssel Wood, Fire, Earth, Metal und Water, jeder Eintrag hat die Form {count, percentage, meaning, associated_numbers}. Zu Holz gehören 3 und 4, zu Feuer 9, zu Erde 2, 5 und 8, zu Metall 6 und 7, zu Wasser 1; Nullen werden nirgends gezählt. Nur im chinesischen System.
growth_number	—	Geburtstag plus Geburtsmonat, reduziert. Eine einzelne Ganzzahl 1-9. Verfügbar, wenn `system` `chaldean` oder `pythagorean` ist; die anderen liefern 400.
hidden_passion_number	—	Der Buchstabenwert, der im vollständigen Namen am häufigsten vorkommt – das Talent, das der Name immer wieder betont. Eine einzelne Ganzzahl; kommen mehrere Werte gleich oft vor, wird der kleinste geliefert, und 0, wenn der Name keine bewertbaren Buchstaben enthält. Verfügbar, wenn `system` `chaldean` oder `pythagorean` ist; die anderen liefern 400.
house_number	house_number	Die Ziffern der im Feld house_number übergebenen Haus- oder Wohnungsnummer, addiert und auf eine einzelne Ziffer reduziert. Eine einzelne Ganzzahl 1-9 oder 0, wenn der Wert keine Ziffern enthält. Nur im chinesischen System, und das Anfragefeld ist erforderlich, sobald dieser Key angefordert wird.
karmic_debt_numbers	—	Die Buchstabenwerte, die im vollständigen Namen nie vorkommen – in den meisten Systemen heißen sie karmische Lektionen, nicht karmische Schulden. Liefert eine Liste der fehlenden Werte, unter Chaldean aus dem Bereich 1-8 (die Tabelle kennt keine 9), unter Pythagorean aus 1-9. Die klassischen Schuldzahlen 13/14/16/19 werden nicht geliefert. Verfügbar, wenn `system` `chaldean` oder `pythagorean` ist; die anderen liefern 400.
life_path_number	—	Geburtstag, -monat und -jahr werden einzeln reduziert, addiert und erneut reduziert. Eine einzelne Ganzzahl; unter Pythagorean bleiben 11 und 22 erhalten. Vergleiche personal_life_path_number und bhagyank: Sie summieren stattdessen direkt die einzelnen Ziffern des Datums und können ein anderes Ergebnis liefern. Verfügbar, wenn `system` `chaldean` oder `pythagorean` ist; die anderen liefern 400.
loshu_grid_arrows	—	Die vier Lo-Shu-Pfeile, geprüft anhand der Frage, ob das Geburtsdatum alle drei Ziffern einer Linie enthält. Liefert ein Objekt mit den Schlüsseln arrow_of_determination (1-5-9), arrow_of_emotional_balance (2-5-8), arrow_of_practicality (1-4-7) und arrow_of_intellect (3-6-9), jeweils {present, meaning}. Gemeldet wird nur, ob ein Pfeil vorhanden ist; leere Pfeile gelten nicht als eigener Befund. Nur im chinesischen System.
lucky_numbers	—	Die Glückszahlen des chinesischen Tierkreiszeichens des Geburtsjahres, ergänzt um die allgemein günstigen Zahlen 8, 6 und 9. Liefert eine sortierte Liste unterschiedlicher Ganzzahlen, meist vier bis sechs. Nur im chinesischen System.
maturity_number	—	Ausdruckszahl plus Lebenszahl, reduziert. Eine einzelne Ganzzahl; unter Pythagorean bleiben 11 und 22 erhalten. Verfügbar, wenn `system` `chaldean` oder `pythagorean` ist; die anderen liefern 400.
moolank	—	Die vedische psychische Zahl: der auf eine Ziffer reduzierte Geburtstag. Eine einzelne Ganzzahl 1-9. Nur im vedischen System; der Wert ist identisch mit psychic_number.
namank	—	Die vedische Namenszahl: der vollständige Name, nach der chaldäischen Buchstabentabelle bewertet und reduziert. Eine einzelne Ganzzahl 1-9. Nur im vedischen System; verwendet wird in jedem Fall die chaldäische Tabelle.
name_number	—	Nur der Vorname – alles bis zum ersten Leerzeichen –, mit der gewählten Buchstabentabelle umgerechnet, summiert und reduziert. Eine einzelne Ganzzahl 1-9; Meisterzahlen bleiben hier auch unter Pythagorean nicht erhalten. Verfügbar, wenn `system` `chaldean` oder `pythagorean` ist; die anderen liefern 400.
personal_life_path_number	—	Alle Ziffern des Geburtsdatums im Format DDMMYYYY, addiert und auf eine einzelne Ziffer reduziert. Eine einzelne Ganzzahl 1-9. Nur im chinesischen System; der vedische Key bhagyank berechnet denselben Wert.
personal_year_number	year	Das Thema eines bestimmten Kalenderjahres: Geburtstag, Geburtsmonat und Zieljahr werden jeweils zuerst reduziert, dann addiert und erneut reduziert. Nimmt year entgegen, standardmäßig das aktuelle Jahr. Eine einzelne Ganzzahl 1-9 und der einzige Key, den es in jedem System gibt.
personality_number	—	Die Konsonanten des vollständigen Namens, summiert und reduziert – der Eindruck nach außen, im Gegensatz zum inneren Antrieb von soul_urge_number. Eine einzelne Ganzzahl 1-9, nie eine Meisterzahl. Verfügbar, wenn `system` `chaldean` oder `pythagorean` ist; die anderen liefern 400.
phone_number	phone_number	Die Ziffern der im Feld phone_number übergebenen Telefonnummer, addiert und reduziert. Eine einzelne Ganzzahl 1-9 oder 0, wenn keine Ziffern vorhanden sind. Nur im chinesischen System, und das Feld ist erforderlich, sobald dieser Key angefordert wird.
pinnacle_cycles	—	Die vier Höhepunkte, die aufeinanderfolgenden Lebensphasen der pythagoreischen Numerologie, gebildet aus reduziertem Geburtsmonat, -tag und -jahr. Liefert {first, second, third, fourth}, jeweils eine Ganzzahl; 11 und 22 bleiben erhalten. Nur im pythagoreischen System.
psychic_number	—	Die Wurzel- oder psychische Zahl: der Tag im Geburtsmonat, auf eine einzelne Ziffer reduziert. Eine einzelne Ganzzahl 1-9. Nur im chaldäischen und im pythagoreischen System.
rational_thought	—	Die Buchstabensumme des Vornamens plus der Geburtstag, reduziert – gedeutet als die Art, wie jemand ein Problem durchdenkt. Eine einzelne Ganzzahl 1-9. Nur im pythagoreischen System.
soul_urge_number	—	Die Herzenswunschzahl: nur die Vokale des vollständigen Namens, summiert und reduziert. Eine einzelne Ganzzahl; unter Pythagorean bleiben 11 und 22 erhalten. A, E, I, O und U zählen, Y nicht. Verfügbar, wenn `system` `chaldean` oder `pythagorean` ist; die anderen liefern 400.
unlucky_numbers	—	Die Unglückszahlen desselben Tierkreiszeichens, ergänzt um die 4. Liefert eine sortierte Liste unterschiedlicher Ganzzahlen. Nur im chinesischen System.
vedic_grid	—	Das 3×3-Geburtsraster mit den herrschenden Planeten. Liefert {grid, grid_layout, details}: grid_layout ist die feste Anordnung [[4,9,2],[3,5,7],[8,1,6]], grid gibt an denselben Positionen an, wie oft jede dieser Ziffern im Geburtsdatum vorkommt, und details hat die Schlüssel '1' bis '9' mit {planet, meaning, count, active}. Nur im vedischen System.
vedic_personal_day	year, month, day	Der persönliche Tag: ((vedischer persönlicher Monat + Zieltag − 1) mod 9) + 1. Nimmt year, month und day entgegen, jeweils standardmäßig die heutigen. Eine einzelne Ganzzahl 1-9. Nur im vedischen System.
vedic_personal_month	year, month	Der persönliche Monat: ((vedisches persönliches Jahr + Zielmonat − 1) mod 9) + 1. Nimmt year und month entgegen, jeweils standardmäßig die heutigen. Eine einzelne Ganzzahl 1-9. Nur im vedischen System.
vedic_personal_year	year	Das persönliche Jahr nach der vedischen Formel ((Geburtstag + Geburtsmonat + Zieljahr − 1) mod 9) + 1. Beachte: Die Formel addiert die unreduzierten Werte, statt jeden zuerst zu reduzieren, und kann deshalb für dieselbe Person und dasselbe Jahr von personal_year_number abweichen. Nimmt year entgegen, standardmäßig das aktuelle Jahr. Eine einzelne Ganzzahl 1-9. Nur im vedischen System.

Beispielanfrage

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

Antwort

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

Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data, jeweils unter dem Key, den du angefordert hast.

Fehler

Abrechnungsfehler liefern { "error": "…", "message": "<code>", "is_error": true }. Zeig deinen Nutzern error an und verzweige im Code anhand von message. Details in der Fehlerreferenz.