/api/astro/dosha/1 créditoDoshas
Un dosha es una aflicción concreta de una carta natal: una configuración planetaria con nombre propio que los textos clásicos consideran un factor negativo, casi siempre para el matrimonio, la salud o el linaje. Este endpoint comprueba ocho de ellos a partir del momento y el lugar del nacimiento, y puede devolver los resultados en bruto o explicaciones redactadas listas para mostrar. Hay dos formas de usarlo. Las claves individuales (`kala_sarpa`, `manglik`, `pitru_dosha` y el resto) devuelven resultados estructurados que puedes procesar en tu código. `get_dosha_details` devuelve todo el conjunto como párrafos HTML con formato, indexados por el nombre del dosha en inglés, que es lo que necesitas si vas a generar un informe; cubre Kala Sarpa, Manglik, Pitru, Guru Chandala, Kalathra, Ghata y Shrapit, pero no Ganda Moola. `get_dosha_resources` te da el corpus de textos subyacente si prefieres redactar tu propio contenido. El serializer exige todos los campos booleanos y estructurados de la solicitud, incluso para las claves que los ignoran. `manglik_reference_planet` es un índice de planeta (0 Sol, 1 Luna, 2 Marte, 3 Mercurio, 4 Júpiter, 5 Venus, 6 Saturno, 7 Rahu, 8 Ketu); el valor por defecto del propio motor, que cuenta desde el ascendente, no se puede elegir mediante la API, porque el campo es de tipo entero. Este endpoint llama `timezone` al campo de la diferencia con UTC, no `timezone_as_float`.
https://api.occultapi.com/api/astro/dosha/Autenticación
Envía tu clave en la cabecera X-API-Key. La clave es una credencial de servidor: nunca la pongas en el JavaScript del navegador ni en una app móvil.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonCampos de la solicitud
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| apply_exceptions | boolean | obligatorio | |
| 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. Restricción de FORMATO. DRF DateTimeField: solo ISO-8601 (formatos de entrada por defecto de DRF), p. ej., "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" o "2026-09-01 06:00:00" (sin zona horaria = se toma como UTC). |
| include_2nd_house | boolean | obligatorio | |
| include_lagna_house | boolean | obligatorio | |
| 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. get_dosha_resourceskala_sarpamanglikpitru_doshaguru_chandala_doshakalathraganda_moolaghatashrapitget_dosha_detailsArray de cadenas. 'manglik' requiere manglik_reference_planet, include_lagna_house, include_2nd_house y apply_exceptions; 'ganda_moola' requiere moon_star; 'get_dosha_details' requiere date_time y geopos. |
| 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 |
| manglik_reference_planet | integer | obligatorio | |
| moon_star | string | obligatorio | En realidad es un NÚMERO de nakshatra, 1-27 (los nakshatras de Ganda Moola son 1 Ashwini, 9 Ashlesha, 10 Magha, 18 Jyeshtha, 19 Moola, 27 Revati). No se puede publicar una lista de valores aceptados que funcione hasta que se corrija esa discrepancia de tipos. |
| 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. |
Claves disponibles (10)
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 |
|---|---|---|
| ganda_moola | moon_star | Ganda Moola: indica si la estrella de nacimiento es uno de los seis nakshatras de unión (Ashwini, Ashlesha, Magha, Jyeshtha, Moola, Revati). Debería recibir el número de nakshatra 1–27 en `moon_star` y devolver un booleano, pero el campo está tipado como cadena y la lista con la que se compara contiene enteros, así que, tal como está, la clave devuelve false para cualquier valor. |
| get_dosha_details | date_time, geopos | Los siete doshas con texto, evaluados y redactados de una vez: un objeto indexado por el nombre del dosha en inglés (Kala Sarpa Dosha, Manglik Dosha, Pitru Dosha, Guru Chandala Dosha, Kalathra Dosha, Ghata Dosha y Shrapit Dosha), cuyos valores son fragmentos HTML que indican si el dosha está presente y qué significa. No incluye Ganda Moola. Requiere `date_time` y el lugar. |
| get_dosha_resources | — | Todos los textos explicativos de los doshas, como objeto indexado por nombre de dosha ('kala_sarpa', 'manglik', 'pitru', 'ghata', etc.), con una lista de párrafos en inglés para cada uno. La primera entrada de cada lista es el texto para cuando no hay dosha, y las siguientes corresponden a la casa o la variedad de que se trate. Úsalo para componer tu propio texto en lugar de usar el HTML ya montado. |
| ghata | — | Ghata Dosha: Marte y Saturno juntos en el mismo signo. Devuelve un único booleano. |
| guru_chandala_dosha | — | Guru Chandala: Júpiter en conjunción con Rahu o Ketu en el mismo signo. Devuelve una lista de dos elementos: [si la combinación está presente, si Júpiter es el más fuerte de los dos]. Si no hay conjunción, los dos son false. |
| kala_sarpa | — | Kala Sarpa Dosha: true cuando los siete planetas clásicos están encerrados entre Rahu y Ketu, a un lado del eje nodal. Devuelve un único booleano; la variedad (Ananta, Kulika, Vasuki, etc.) se deduce de la casa que ocupa Rahu. |
| kalathra | — | Kalathra Dosha, la aflicción de la casa del matrimonio. Es true cuando todos los maléficos naturales (Sol, Marte, Saturno, Rahu y Ketu) caen en la casa 1, 2, 4, 7, 8 o 12 contada desde la casa séptima. Devuelve un único booleano y, como exige que se cumpla para los cinco maléficos, rara vez es true. |
| manglik | manglik_reference_planet, include_lagna_house, include_2nd_house, apply_exceptions | Manglik, o Mangal Dosha: indica si Marte cae en alguna de las casas que afligen el matrimonio, contadas desde `manglik_reference_planet`. Devuelve una lista de tres elementos: [es manglik, si hay una cancelación, los números de las reglas de cancelación que se cumplen]. Se comprueban las casas 4, 7, 8 y 12, además de la 2 si `include_2nd_house` es true y la 1 si `include_lagna_house` es true; las cancelaciones solo se evalúan si `apply_exceptions` es true. |
| pitru_dosha | — | Pitru Dosha, la aflicción del linaje. Devuelve una lista de dos elementos: [true o false, los números de las reglas que se activaron]. Se comprueban cinco reglas por orden: una luminaria o Rahu en la casa 9, Ketu en la 4, Sol/Luna/Rahu/Ketu afligidos por Marte o Saturno, una concentración de Mercurio, Venus y Rahu en la 2, 5, 9 o 12, y el Sol o la Luna en conjunción con un nodo. |
| shrapit | — | Shrapit Dosha: Saturno y Rahu juntos en el mismo signo. Devuelve un único booleano. |
Ejemplo de solicitud
curl -X POST https://api.occultapi.com/api/astro/dosha/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_dosha_resources"],"date_time":"2025-07-11T04:37:08.718Z","latitude":26.9124,"longitude":75.7873,"timezone":0,"manglik_reference_planet":0,"include_lagna_house":true,"include_2nd_house":true,"apply_exceptions":true,"moon_star":"leo"}'Respuesta
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"get_dosha_resources\": {\"kala_sarpa\": [\"There is no Kala Sarpa Dosha in this horoscope.\", \"Ananta Kala Sarpa Dosha- Rahu in 1st House and Ketu in 7th House. In this Dosha, Rahu is placed in the 1st house and Ketu in the 7th house in the horoscope. All planets are placed between Rahu-Ketu from the 1st house to the 7th house. This alignment can make a person ill-tempered and bring health issues. There would be problems in marital relationships, and, if in business, there would be a lack of support from partners.\", \"Kulik Kala Sarpa Dosha- Rahu in 2nd House and Ketu in 8th House. This Dosha is formed when Rahu is in the 2nd house and Ketu is in the 8th house, and all planets are between them. The individual afflicted may be vile-tongued and lead a life without the support of relatives. Monetary problems might surface, and savings might not be possible. The afflicted native may undergo surgery or accidents. There may be a possibility of unnatural death.\", \"Vasuki Kala Sarpa Dosha- Rahu in 3rd House and Ketu in 9th House. This Dosha is formed in the horoscope when Rahu and Ketu are in the 3rd, and 9th houses, respectively, and the remaining planets are hemmed between them. The afflicted individual may be timid in disposition and unable to fight for self-esteem. Relationships with younger siblings might not be good. Tide will go against the individual who may be unable to overcome adversity. The native can lack interest in religion, and luck may not favor them.\", \"Shankapal Kala Sarpa Dosha- Rahu in 4th House and Ketu in 10th House. This Dosha is formed when all planets are between Rahu and Ketu, which are placed from the 4th house to the 10th house. This alignment causes the native to have a bad relationship with the mother. The individual might not have mental peace and face professional problems.\", \"Padma Kala Sarpa Dosha- Rahu in 5th House and Ketu in 11th House. The axis of Rahu-Ketu from the 5th house to the 11th house and all planets within this axis cause this Dosha. The afflicted individual can face an issue with childbirth and education. They may have problems earning and may get into conflict with elder siblings.\", \"Mahapadma Kala Sarpa Dosha- Rahu in 6th House and Ketu in 12th House. The alignment of all planets in the Rahu-Ketu axis of the 6th house to the 12th house causes this Dosha. The afflicted individual can be dominated by enemies and lose money and property. The native could waste money, be unpopular, and have conflicts with in-laws.\", \"Takshak Kala Sarpa Dosha- Rahu in 7th House and Ketu in 1st House. The placement of all planets in the axis of Rahu-Ketu from the 7th house to the 1st house cause this Dosha. The afflicted may not go through marriage. If married, then the marriage might not go well. This Dosha can create a rift between the couple, leading to separation.\", \"Karakotak Kala Sarpa Dosha- Rahu in 8th House and Ketu in 2nd House. The placement of Rahu in the 8th house and Ketu in the 2nd house and the remaining planets in between them can cause this Dosha. The afflicted native might be ill-tempered and befriend anti-social elements. The native might have enemies and not be granted paternal wealth.\", \"Shankachood Kala Sarpa Dosha- Rahu in 9th House and Ketu in 3rd House. When Rahu is placed in the 9th house, Ketu in the 3rd house and all planets are between Rahu and Ketu; this Dosha is created in the horoscope. An afflicted individual might struggle a lot in life, and luck may never favor them. The individual may develop a habit of lying constantly and could be short-tempered.\", \"Ghatak Kala Sarpa Dosha- Rahu in 10th House and Ketu in 4th House. This Dosha is formed when Rahu is placed in the 10th house, Ketu in the 4th house, and all the planets are between the 10th to 4th houses. The afflicted individual may face many hurdles in his profession and conflicts with superiors at work. The individual may lack focus and face criticism. Relationships with family members may be poor. There may be de"
}Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data, cada uno bajo la clave que pediste.
Errores
Los errores de control de uso devuelven { "error": "…", "message": "<code>", "is_error": true }. Muestra error al usuario y usa message para decidir qué hace tu código. Consulta la referencia de errores.