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

Navamsa (D9)

Le navamsa, le neuvième thème divisionnaire : chaque signe divisé en neuf parts de 3°20' chacune. Après le thème rashi, c’est le thème le plus important. On le consulte pour le mariage et les partenariats, pour le dharma, et pour contrôler le thème rashi - une planète forte en D1 mais faible ici promet généralement plus qu’elle ne tient. Une planète qui occupe le même signe dans les deux thèmes est vargottama et réputée particulièrement forte. Renvoie la même structure plate que /api/astro/planet-positions/ : les planètes sous forme de liste dans l’ordre traditionnel, avec `name`, longitude, signe, nakshatra, pada et maison pour chacune, ainsi que l’ascendant et l’ayanamsa appliqué. Envoyez une date et un lieu ; `ayanamsa` vaut LAHIRI par défaut et les 48 sont acceptés. Le thème est fixé par la route : un `chart_name` envoyé dans le corps est donc ignoré - cet endpoint ne peut renvoyer que le thème dont il porte le nom. Pour les 24 autres divisions, utilisez /api/astro/chart/.

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

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
chart_name	string	obligatoire
datetime	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. Même signification que date_time, que d’autres endpoints désignent sous un autre nom.
latitude	number (double)	obligatoire	Latitude du lieu, en degrés décimaux. Positive au nord, négative au sud. Exemple : 26.9124 pour Jaipur, 40.7128 pour New York. Les minutes et les secondes ne sont pas acceptées - convertissez d’abord. min -89.9 · max 89.9
longitude	number (double)	obligatoire	Longitude du lieu, en degrés décimaux. Positive à l’est, négative à l’ouest. Exemple : 75.7873 pour Jaipur, -74.0060 pour New York. Attention au signe : sans le moins, New York se retrouve en Chine. min -180 · max 180
aberration	boolean	facultatif
apply_correction	boolean	facultatif
ascendant_pos	string	facultatif	`cuspstartend`
ayanamsa	string	facultatif
background_color	string	facultatif	Couleur hexadécimale de l’arrière-plan SVG.
chart_style	string	facultatif	Style de diagramme lorsque render='svg'. 'north' est la disposition en losange, avec maisons fixes et signes tournants ; 'south' est la grille à signes fixes, avec maisons tournantes. `northsouth`
correction_deg	integer	facultatif	min 0
correction_direction	string	facultatif	`addsubtract`
correction_min	integer	facultatif	min 0 · max 59
correction_sec	integer	facultatif	min 0 · max 59
extended_bodies	array	facultatif	Groupes de corps à inclure : 'asteroids', 'planetary_moons', 'fictitious_bodies'.
label_style	string	facultatif	Manière de libeller les planètes : 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) ou 'symbol' (☉, ☽, ...). `englishsanskritsymbol`
line_color	string	facultatif	Couleur hexadécimale des lignes de la grille du thème.
notation	string	facultatif	`astrologicaldegree`
nutation	boolean	facultatif
planet_color	string	facultatif	Couleur hexadécimale des libellés des planètes, p. ex. '#111827'. Par défaut : la couleur propre au thème visuel.
rahu	string	facultatif	Type de nœud à inclure. 'true' ne renvoie que les nœuds vrais, 'mean' que les nœuds moyens, 'both' renvoie les deux. `truemeanboth`
refraction	boolean	facultatif
render	string	facultatif	Mettre à 'svg' pour renvoyer aussi un diagramme du thème rendu (voir chart_style) et la géométrie qui le sous-tend. Si vous l’omettez entièrement, la réponse reste inchangée. `nonesvg`
show_degrees	boolean	facultatif	Afficher, à côté du libellé de chaque corps, son degré dans le signe.
sign_color	string	facultatif	Couleur hexadécimale des numéros et abréviations des signes.
svg_size	integer	facultatif	Largeur et hauteur du viewBox SVG carré, en pixels. min 100 · max 2000
theme	string	facultatif	`lightdark`
true_mean	string	facultatif	`TrueMean`
use_28_nakshatras	boolean	facultatif

Exemple de requête

curl -X POST https://api.occultapi.com/api/astro/navamsa/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2026-09-01T06:00:00+05:30","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"ayanamsa":"LAHIRI"}'

Réponse

{
  "data": {
    "planets": [
      {
        "name": "sun",
        "longitude": 129.4275,
        "latitude": 0,
        "nakshatra": "Makha",
        "pada": 3,
        "kakshya": "mars",
        "zodiac_name": "Leo",
        "house": 2
      },
      {
        "name": "moon",
        "longitude": 13.3,
        "latitude": 4.37,
        "nakshatra": "Ashwini",
        "pada": 4,
        "kakshya": "sun",
        "zodiac_name": "Aries",
        "house": 10
      },
      {
        "name": "mars",
        "longitude": 352.5725,
        "latitude": 0.535,
        "nakshatra": "Revati",
        "pada": 2,
        "kakshya": "moon",
        "zodiac_name": "Pisces",
        "house": 9
      },
      {
        "name": "mercury",
        "longitude": 166.57000000000002,
        "latitude": 1.574,
        "nakshatra": "Hasta",
        "pada": 2,
        "kakshya": "venus",
        "zodiac_name": "Virgo",
        "house": 3
      },
      {
        "name": "jupiter",
        "longitude": 265.24749999999995,
        "latitude": 0.529,
        "nakshatra": "Poorvaashaadha",
        "pada": 4,
        "kakshya": "moon",
        "zodiac_name": "Sagittarius",
        "house": 6
      },
      {
        "name": "venus",
        "longitude": 170.60249999999996,
        "latitude": -3.391,
        "nakshatra": "Hasta",
        "pada": 4,
        "kakshya": "Mercury",
        "zodiac_name": "Virgo",
        "house": 3
      },
      {
        "name": "saturn",
        "longitude": 265.02250000000004,
        "latitude": -2.651,
        "nakshatra": "Poorvaashaadha",
        "pada": 4,
        "kakshya": "moon",
        "zodiac_name": "Sagittarius",
        "house": 6
      },
      {
        "name": "northtruenode",
        "longitude": 230.0925,
        "latitude": 0,
        "nakshatra": "Jyeshtha",
        "pada": 2,
        "kakshya": "Mercury",
        "zodiac_name": "Scorpio",
        "house": 5
      },
      {
        "name": "southtruenode",
        "longitude": 50.092499999999994,
        "latitude": 0,
        "nakshatra": "Rohini",
        "pada": 4,
        "kakshya": "Mercury",
        "zodiac_name": "Taurus",
        "house": 11
      },
      {
        "name": "uranus",
        "longitude": 12.814999999999984,
        "latitude": -0.154,
        "nakshatra": "Ashwini",
        "pada": 4,
        "kakshya": "sun",
        "zodiac_name": "Aries",
        "house": 10
      },
      {
        "name": "neptune",
        "longitude": 174.89499999999998,
        "latitude": -1.412,
        "nakshatra": "Chitra",
        "pada": 1,
        "kakshya": "moon",
        "zodiac_name": "Virgo",
        "house": 3
      },
      {
        "name": "pluto",
        "longitude": 353.51,
        "latitude": -4.3,
        "nakshatra": "Revati",
        "pada": 3,
        "kakshya": "moon",
        "zodiac_name": "Pisces",
        "house": 9
      }
    ],
    "ascendant": {
      "longitude": 132.1878846274937,
      "zodiac_name": "Cancer",
      "nakshatra": "Makha",
      "pada": 4
    },
    "ayanamsa": {
      "name": "LAHIRI",
      "corrected": false,
      "value_degrees": 24.229599,
      "formatted": "24°13'47\""
    }
  },
  "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.

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.