/api/astro/dasha/vimshottari/1 créditDasha Vimshottari
Le cycle de 120 ans sur lequel repose presque toute lecture védique. La Vimshottari part du nakshatra qu’occupait la Lune à la naissance, ce qui détermine à la fois la mahadasha en cours à la naissance et la part qu’il en restait. Elle fait ensuite se succéder les neuf grahas sur 120 ans, dans un ordre et avec des durées fixes : Ketu 7, Vénus 20, Soleil 6, Lune 10, Mars 7, Rahu 18, Jupiter 16, Saturne 19, Mercure 17. Renvoyée sous forme de chronologie imbriquée — mahadasha, puis antardasha, puis pratyantardasha —, chaque période avec son maître ainsi que son début et sa fin exacts. Contrairement aux autres dashas de nakshatra, la Vimshottari est inconditionnelle : elle s’applique à tous les thèmes.
https://api.occultapi.com/api/astro/dasha/vimshottari/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/jsonChamps de la requête
| Champ | Type | Obligatoire | Remarques |
|---|---|---|---|
| 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 -90 · max 90 |
| 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 |
| dasha_direction | string | facultatif | forwardbackward |
| dasha_start | string | facultatif | Le cycle par lequel commence la chronologie. currentnextprevious |
| date_time | string (date-time) | facultatif | 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. |
| datetime | string (date-time) | facultatif | 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. |
| days_in_year | number (double) | facultatif | Longueur de l’année utilisée pour mesurer les périodes. 360 pour l’année savana classique, 365.25 pour l’année julienne. min 360 · max 365.256364 |
| levels | integer | facultatif | Profondeur d’imbrication : 1 pour la mahadasha seule, 2 ajoute l’antardasha, 3 ajoute la pratyantardasha. Plafonnée à 4, car la réponse est environ décuplée à chaque niveau. min 1 · max 4 |
| node | string | facultatif | Modèle de nœud lunaire. Obligatoire sur l’endpoint parent rashi, qui n’a pas de valeur par défaut ; ici, une valeur par défaut est prévue. truemean |
| timezone_as_float | number (double) | facultatif | Décalage UTC du lieu, en heures, sous forme décimale. Exemple : 5.5 pour l’Inde (UTC+05:30), -5 pour New York en hiver, 5.75 pour le Népal. Cette valeur n’est PAS contrôlée par rapport à date_time - si les deux divergent, vous obtenez une réponse réussie pour le mauvais moment ; tirez donc les deux de la même source. Utilisez le décalage en vigueur à cette date, pas celui d’aujourd’hui : une naissance en été dans un pays qui applique l’heure d’été exige le décalage d’été. min -12 · max 14 |
Exemple de requête
curl -X POST https://api.occultapi.com/api/astro/dasha/vimshottari/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"levels":3}'Réponse
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"system\": \"Vimshottari\", \"engine_id\": \"VimshottariDasha\", \"family\": \"nakshatra\", \"lord_type\": \"planet\", \"levels\": 3, \"level_names\": [\"mahadasha\", \"antardasha\", \"pratyantardasha\"], \"cycle_years\": 120, \"conditional\": false, \"periods\": [{\"lord\": \"moon\", \"start\": \"1983-12-03 22:34:05.606114+00:00\", \"end\": \"1993-12-03 10:34:05.606114+00:00\", \"children\": [{\"lord\": \"moon\", \"start\": \"1983-12-03 22:34:05.606114+00:00\", \"end\": \"1984-10-03 06:34:05.606114+00:00\", \"children\": [{\"lord\": \"moon\", \"start\": \"1983-12-03 22:34:05.606114+00:00\", \"end\": \"1983-12-29 06:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"mars\", \"start\": \"1983-12-29 06:34:05.606114+00:00\", \"end\": \"1984-01-16 00:10:05.606114+00:00\", \"children\": []}, {\"lord\": \"rahu\", \"start\": \"1984-01-16 00:10:05.606114+00:00\", \"end\": \"1984-03-01 14:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"jupiter\", \"start\": \"1984-03-01 14:34:05.606114+00:00\", \"end\": \"1984-04-11 03:22:05.606114+00:00\", \"children\": []}, {\"lord\": \"saturn\", \"start\": \"1984-04-11 03:22:05.606114+00:00\", \"end\": \"1984-05-29 06:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"mercury\", \"start\": \"1984-05-29 06:34:05.606114+00:00\", \"end\": \"1984-07-11 08:10:05.606114+00:00\", \"children\": []}, {\"lord\": \"ketu\", \"start\": \"1984-07-11 08:10:05.606114+00:00\", \"end\": \"1984-07-29 01:46:05.606114+00:00\", \"children\": []}, {\"lord\": \"venus\", \"start\": \"1984-07-29 01:46:05.606114+00:00\", \"end\": \"1984-09-17 17:46:05.606114+00:00\", \"children\": []}, {\"lord\": \"sun\", \"start\": \"1984-09-17 17:46:05.606114+00:00\", \"end\": \"1984-10-02 22:34:05.606114+00:00\", \"children\": []}]}, {\"lord\": \"mars\", \"start\": \"1984-10-03 06:34:05.606114+00:00\", \"end\": \"1985-05-04 07:22:05.606114+00:00\", \"children\": [{\"lord\": \"mars\", \"start\": \"1984-10-03 06:34:05.606114+00:00\", \"end\": \"1984-10-15 16:46:05.606114+00:00\", \"children\": []}, {\"lord\": \"rahu\", \"start\": \"1984-10-15 16:46:05.606114+00:00\", \"end\": \"1984-11-16 15:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"jupiter\", \"start\": \"1984-11-16 15:34:05.606114+00:00\", \"end\": \"1984-12-15 01:10:05.606114+00:00\", \"children\": []}, {\"lord\": \"saturn\", \"start\": \"1984-12-15 01:10:05.606114+00:00\", \"end\": \"1985-01-17 18:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"mercury\", \"start\": \"1985-01-17 18:34:05.606114+00:00\", \"end\": \"1985-02-16 22:46:05.606114+00:00\", \"children\": []}, {\"lord\": \"ketu\", \"start\": \"1985-02-16 22:46:05.606114+00:00\", \"end\": \"1985-03-01 08:58:05.606114+00:00\", \"children\": []}, {\"lord\": \"venus\", \"start\": \"1985-03-01 08:58:05.606114+00:00\", \"end\": \"1985-04-05 20:58:05.606114+00:00\", \"children\": []}, {\"lord\": \"sun\", \"start\": \"1985-04-05 20:58:05.606114+00:00\", \"end\": \"1985-04-16 12:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"moon\", \"start\": \"1985-04-16 12:34:05.606114+00:00\", \"end\": \"1985-05-04 06:34:05.606114+00:00\", \"children\": []}]}, {\"lord\": \"rahu\", \"start\": \"1985-05-04 07:22:05.606114+00:00\", \"end\": \"1986-11-03 02:34:05.606114+00:00\", \"children\": [{\"lord\": \"rahu\", \"start\": \"1985-05-04 07:22:05.606114+00:00\", \"end\": \"1985-07-25 08:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"jupiter\", \"start\": \"1985-07-25 08:34:05.606114+00:00\", \"end\": \"1985-10-06 06:58:05.606114+00:00\", \"children\": []}, {\"lord\": \"saturn\", \"start\": \"1985-10-06 06:58:05.606114+00:00\", \"end\": \"1985-12-31 21:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"mercury\", \"start\": \"1985-12-31 21:34:05.606114+00:00\", \"end\": \"1986-03-19 09:22:05.606114+00:00\", \"children\": []}, {\"lord\": \"ketu\", \"start\": \"1986-03-19 09:22:05.606114+00:00\", \"end\": \"1986-04-20 07:10:05.606114+00:00\", \"children\": []}, {\"lord\": \"venus\", \"start\": \"1986-04-20 07:10:05.606114+00:00\", \"end\": \"1986-07-20 11:10:05.606114+00:00\", \"children\": []}, {\"lord\": \"sun\", \"start\": \"1986-07-20 11:10:05.606114+00:00\", \"end\": \"1986-08-16 19:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"moon\", \"start\": \"1986-08-16 19:34:05.606114+00:00\", \"end\": \"1986-10-01 09:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"mars\", \"start\": \"1986-10-01 09:34:05.606114+00:00\", \"end\": \"1986-11-02 07:"
}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.