POST/api/astro/saptamsa/1 crédito

Saptamsa (D7)

El saptamsa, la séptima carta divisional: cada signo dividido en siete partes de aproximadamente 4°17' cada una. Se interpreta para los hijos y la descendencia. Devuelve la misma estructura plana que /api/astro/planet-positions/: los planetas como lista en el orden tradicional, cada uno con `name`, longitud, signo, nakshatra, pada y casa, además del ascendente y el ayanamsa aplicado. Envía una fecha y un lugar; `ayanamsa` es LAHIRI por defecto y se aceptan los 48. La ruta fija la carta, así que un `chart_name` en el cuerpo se ignora: este endpoint solo puede devolver la carta que le da nombre. Para las otras 24 divisiones, usa /api/astro/chart/.

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

Probar solicitud

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/json

Campos de la solicitud

Campo	Tipo	Obligatorio	Notas
chart_name	string	obligatorio
datetime	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. Significa lo mismo que date_time; otros endpoints simplemente le dan ese otro nombre.
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 -89.9 · max 89.9
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
aberration	boolean	opcional
apply_correction	boolean	opcional
ascendant_pos	string	opcional	`cuspstartend`
ayanamsa	string	opcional
background_color	string	opcional	Color hexadecimal del fondo del SVG.
chart_style	string	opcional	Estilo del diagrama cuando render='svg'. 'north' es el diseño en rombo, con las casas fijas y los signos rotando; 'south' es la cuadrícula de signos fijos, con las casas rotando. `northsouth`
correction_deg	integer	opcional	min 0
correction_direction	string	opcional	`addsubtract`
correction_min	integer	opcional	min 0 · max 59
correction_sec	integer	opcional	min 0 · max 59
extended_bodies	array	opcional	Grupos de cuerpos que incluir: 'asteroids', 'planetary_moons', 'fictitious_bodies'.
label_style	string	opcional	Cómo se rotulan los planetas: 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) o 'symbol' (☉, ☽, ...). `englishsanskritsymbol`
line_color	string	opcional	Color hexadecimal de las líneas de la cuadrícula de la carta.
notation	string	opcional	`astrologicaldegree`
nutation	boolean	opcional
planet_color	string	opcional	Color hexadecimal de las etiquetas de los planetas, p. ej., '#111827'. Valor por defecto: el color propio del tema.
rahu	string	opcional	Tipo de nodo que se incluye. 'true' devuelve solo los nodos verdaderos; 'mean', solo los nodos medios, y 'both', ambos. `truemeanboth`
refraction	boolean	opcional
render	string	opcional	Ponlo en 'svg' para recibir también un diagrama renderizado de la carta (consulta chart_style) y la geometría en la que se basa. Si no lo envías, la respuesta no cambia. `nonesvg`
show_degrees	boolean	opcional	Muestra el grado de cada cuerpo dentro de su signo junto a su etiqueta.
sign_color	string	opcional	Color hexadecimal de los números y abreviaturas de los signos.
svg_size	integer	opcional	Ancho y alto del viewBox cuadrado del SVG, en píxeles. min 100 · max 2000
theme	string	opcional	`lightdark`
true_mean	string	opcional	`TrueMean`
use_28_nakshatras	boolean	opcional

Ejemplo de solicitud

curl -X POST https://api.occultapi.com/api/astro/saptamsa/ \
  -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"}'

Respuesta

{
  "data": {
    "planets": [
      {
        "name": "sun",
        "longitude": 220.66583333333335,
        "latitude": 0,
        "nakshatra": "Anooraadha",
        "pada": 3,
        "kakshya": "mars",
        "zodiac_name": "Scorpio",
        "house": 2
      },
      {
        "name": "moon",
        "longitude": 10.344444444444443,
        "latitude": 4.37,
        "nakshatra": "Ashwini",
        "pada": 4,
        "kakshya": "mars",
        "zodiac_name": "Aries",
        "house": 7
      },
      {
        "name": "mars",
        "longitude": 194.22305555555556,
        "latitude": 0.535,
        "nakshatra": "Swaati",
        "pada": 3,
        "kakshya": "sun",
        "zodiac_name": "Libra",
        "house": 1
      },
      {
        "name": "mercury",
        "longitude": 249.55444444444444,
        "latitude": 1.574,
        "nakshatra": "Moola",
        "pada": 3,
        "kakshya": "mars",
        "zodiac_name": "Sagittarius",
        "house": 3
      },
      {
        "name": "jupiter",
        "longitude": 46.30361111111111,
        "latitude": 0.529,
        "nakshatra": "Rohini",
        "pada": 2,
        "kakshya": "venus",
        "zodiac_name": "Taurus",
        "house": 8
      },
      {
        "name": "venus",
        "longitude": 172.69083333333333,
        "latitude": -3.391,
        "nakshatra": "Hasta",
        "pada": 4,
        "kakshya": "moon",
        "zodiac_name": "Virgo",
        "house": 12
      },
      {
        "name": "saturn",
        "longitude": 286.1286111111111,
        "latitude": -2.651,
        "nakshatra": "Sravanam",
        "pada": 2,
        "kakshya": "venus",
        "zodiac_name": "Capricorn",
        "house": 4
      },
      {
        "name": "northtruenode",
        "longitude": 338.9608333333333,
        "latitude": 0,
        "nakshatra": "Uttaraabhaadra",
        "pada": 2,
        "kakshya": "mars",
        "zodiac_name": "Pisces",
        "house": 6
      },
      {
        "name": "southtruenode",
        "longitude": 158.96083333333334,
        "latitude": 0,
        "nakshatra": "Uttara Phalguni",
        "pada": 4,
        "kakshya": "mars",
        "zodiac_name": "Virgo",
        "house": 12
      },
      {
        "name": "uranus",
        "longitude": 289.96722222222223,
        "latitude": -0.154,
        "nakshatra": "Sravanam",
        "pada": 3,
        "kakshya": "Mercury",
        "zodiac_name": "Capricorn",
        "house": 4
      },
      {
        "name": "neptune",
        "longitude": 216.02944444444444,
        "latitude": -1.412,
        "nakshatra": "Anooraadha",
        "pada": 1,
        "kakshya": "jupiter",
        "zodiac_name": "Scorpio",
        "house": 2
      },
      {
        "name": "pluto",
        "longitude": 154.95222222222225,
        "latitude": -4.3,
        "nakshatra": "Uttara Phalguni",
        "pada": 3,
        "kakshya": "jupiter",
        "zodiac_name": "Virgo",
        "house": 12
      }
    ],
    "ascendant": {
      "longitude": 205.3144444444445,
      "zodiac_name": "Libra",
      "nakshatra": "Makha",
      "pada": 4
    },
    "ayanamsa": {
      "name": "LAHIRI",
      "corrected": false,
      "value_degrees": 24.229599,
      "formatted": "24°13'47\""
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data.

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.