curl -X POST https://api.occultapi.com/api/astro/raja_yoga/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_raja_yoga_details_for_all_charts"],"date_time":"2025-07-14T11:00:37.673Z","latitude":13,"longitude":77.5946,"timezone":5.5}'Un raja yoga es una combinación de la carta natal a la que se atribuye el poder de otorgar estatus y éxito. El caso principal es una relación entre el señor de una casa angular (1, 4, 7, 10) y el señor de un trígono (1, 5, 9): que estén en conjunción, que se aspecten mutuamente o que intercambien signos. Este endpoint comprueba las tres variantes con nombre propio que implementa el motor: Vipareeta raja yoga (los señores de las casas difíciles, la sexta, la octava y la duodécima, situados en esas mismas casas), Neecha Bhanga raja yoga (un planeta debilitado cuya debilitación queda cancelada) y Dharma-Karmadhipati raja yoga (los señores de la novena y la décima relacionados entre sí). Tiene una sola clave, `get_raja_yoga_details_for_all_charts`, que hace las comprobaciones en todas las cartas divisionales que conoce el motor, no solo en la carta natal. Su valor es un array de tres elementos: un objeto que asocia cada yoga encontrado con sus detalles, el número de yogas encontrados y el número de comprobaciones realizadas (tres tipos de yoga en veintitrés cartas divisionales, es decir, 69). Cada entrada de detalle es una lista de cadenas: primero una línea con la carta divisional y los pares de planetas responsables, como `"D1-Raja Yoga Pairs: [Viyaazhan-Sani]"`, y después el nombre del yoga, su definición y sus efectos previstos. Dos cosas que conviene saber al leer la salida. En la línea de pares, los planetas aparecen siempre en transliteración tamil, envíes lo que envíes: Suriyan es el Sol, Chandran la Luna, Sevvay Marte, Budhan Mercurio, Viyaazhan Júpiter, VeLLi Venus y Sani Saturno. Además, como los resultados de todas las cartas divisionales se fusionan en un único objeto indexado por nombre de yoga, cada yoga aparece una sola vez, asociado a la primera carta divisional en la que se encontró: un prefijo `D4-` significa que la propia carta natal no lo tenía. Una salvedad antes de basarte en este endpoint: actualmente el cálculo subyacente sustituye el `date_time` que envías por una fecha fija, así que el resultado cambia con los campos de ubicación pero no con la fecha de nacimiento. Compruébalo con una carta que conozcas antes de fiarte de él.
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| date_time | string (date-time) | obligatorio | 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. |
| keys | array | obligatorio | Los cálculos que quieres recibir, como lista de nombres. Consulta la tabla de claves de este endpoint; un nombre que no se reconoce invalida toda la solicitud. Cada llamada cuesta un crédito, pidas las claves que pidas, así que pide todo lo que necesites de una vez en lugar de hacer varias llamadas. |
| 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 |
| timezone | number (double) | obligatorio | Diferencia horaria del lugar con UTC, en horas y con decimales. Ejemplo: 5.5 para la India (UTC+05:30). Significa exactamente lo mismo que timezone_as_float; otros endpoints simplemente le dan ese otro nombre. |
Indica en keys exactamente los cálculos que quieres. Si una clave no existe, se rechaza toda la solicitud. Pidas las que pidas, se cobra 1 crédito, así que agrúpalas en una sola llamada.
| Clave | Campos adicionales | Descripción | |
|---|---|---|---|
| get_raja_yoga_details_for_all_charts | — | Revisa todas las cartas divisionales en busca de las tres variantes de raja yoga que implementa el motor: Vipareeta, Neecha Bhanga y Dharma-Karmadhipati. Devuelve un array de tres elementos: un objeto indexado por nombre de yoga con los detalles de cada uno, el número de yogas encontrados y el número de comprobaciones realizadas (69, es decir, tres tipos de yoga en veintitrés cartas). Cada valor de detalle es una lista de cadenas (la carta divisional y los pares de planetas responsables, y después el nombre del yoga, su definición y sus efectos). Como los resultados de las cartas se fusionan en un único objeto, cada yoga aparece una sola vez, asociado a la primera carta en la que se encontró. |