Cargando el Playground
curl -X POST https://api.occultapi.com/api/astro/dasha/drill/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"latitude":26.9124,"longitude":75.7873,"dasha_direction":"forward","dasha_start":"current","date_time":"2026-09-01 06:00:00","node":"true","timezone_as_float":5.5}'Una sola rama de un árbol de dasha, en lugar del árbol entero. En los demás endpoints de dasha, levels limita la PROFUNDIDAD, pero sigue devolviendo todos los periodos de ese nivel: con levels=3, Vimshottari devuelve todos los pratyantardashas de cada antardasha de cada mahadasha, unos 95 KB. Una pantalla en la que el usuario toca un mahadasha para desplegarlo solo necesita una rama de todo eso. Indica a este endpoint la cadena de señores que debe seguir y solo devolverá lo que hay bajo el periodo indicado. {"lords": ["moon", "mars"], "levels": 1} devuelve los pratyantardashas del antardasha de Marte dentro del mahadasha de la Luna: unos 1.8 KB, frente a los 95 KB del árbol que lo contiene. Los nombres de los señores se comparan sin distinguir mayúsculas y minúsculas, y path, en la respuesta, repite la cadena que se encontró realmente. Usa un nombre de planeta para los dashas de nakshatra y un nombre de signo para los dashas de rashi de Jaimini; un señor que no se reconoce devuelve 400 con la lista de lo disponible en ese nivel. Ahorra TRANSFERENCIA, no CÁLCULO. El motor sigue construyendo el árbol hasta la profundidad pedida y este endpoint descarta el resto, así que una consulta de rama no se calcula más rápido que la llamada equivalente con levels=. Lo que ahorra es ancho de banda, análisis de JSON y la memoria que un navegador o un teléfono gasta en guardar un árbol del que solo muestra una rama.
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| latitude | number (double) | obligatorio | Latitud del lugar, en grados decimales. Los valores positivos indican el norte y los negativos, el sur. Ejemplo: 26.9124 para Jaipur, 40.7128 para Nueva York. No se aceptan minutos ni segundos: conviértelos antes. min -90 · max 90 |
| longitude | number (double) | obligatorio | Longitud del lugar, en grados decimales. Los valores positivos indican el este y los negativos, el oeste. Ejemplo: 75.7873 para Jaipur, -74.0060 para Nueva York. Cuidado con el signo: si falta el menos, Nueva York acaba en China. min -180 · max 180 |
| dasha_direction | string | opcional | forwardbackward |
| dasha_start | string | opcional | Ciclo con el que empieza la línea de tiempo. currentnextprevious |
| date_time | string (date-time) | opcional | El momento del cálculo, en ISO 8601. Incluye SIEMPRE la diferencia con UTC o una Z final: un valor sin zona horaria se interpreta como Asia/Kolkata (UTC+05:30), no como UTC, y puede devolver con un 200 el resultado del día anterior. '2026-09-01T06:00:00Z' y '2026-09-01 06:00:00' son instantes distintos y dan respuestas distintas. |
| datetime | string (date-time) | opcional | El momento del cálculo, en ISO 8601. Incluye SIEMPRE la diferencia con UTC o una Z final: un valor sin zona horaria se interpreta como Asia/Kolkata (UTC+05:30), no como UTC. Significa lo mismo que date_time; otros endpoints simplemente le dan ese otro nombre. |
| days_in_year | number (double) | opcional | Duración del año con la que se miden los periodos: 360 para el año savana clásico, 365.25 para el año juliano. min 360 · max 365.256364 |
| levels | integer | opcional | Cuántos niveles POR DEBAJO del periodo encontrado se devuelven. Con 1, solo sus hijos directos. min 1 · max 4 |
| lords | array | opcional | La cadena de señores de periodo que hay que seguir desde arriba, empezando por el más externo; p. ej., ["moon", "mars"] significa «dentro del mahadasha de la Luna, en su antardasha de Marte». Un nombre de planeta para los dashas de nakshatra y un nombre de signo para los dashas de rashi. Si está vacía, devuelve el nivel superior. |
| node | string | opcional | Modelo de nodo lunar. El endpoint padre de rashi lo exige y no le da valor por defecto; aquí sí lo tiene. truemean |
| system | string | opcional | Sistema de dasha. Consulta /api/astro/dasha/systems/. Valor por defecto: Vimshottari. |
| timezone_as_float | number (double) | opcional | Diferencia horaria del lugar con UTC, en horas y con decimales. Ejemplo: 5.5 para la India (UTC+05:30), -5 para Nueva York en invierno, 5.75 para Nepal. NO se contrasta con date_time: si los dos no coinciden, recibes una respuesta correcta para un momento equivocado, así que toma ambos valores de la misma fuente. Usa la diferencia vigente en esa fecha, no la de hoy: para un nacimiento en verano en un país con horario de verano, hace falta la diferencia de verano. min -12 · max 14 |