El año en las eras indias (Vikram, Shaka y Kali) y su nombre en el ciclo joviano de sesenta años.
El año cambia en Chaitra Shukla Pratipada, el año nuevo lunar de marzo o abril, no el 1 de enero: desde enero hasta esa fecha sigue vigente el año anterior. Entre Vikram y Shaka siempre hay 135 años de diferencia, y Kali es Shaka más 3179.
`samvatsara` es el nombre del ciclo joviano, de Prabhava a Kshaya. `samvata_type` elige el cómputo y se devuelve como `samvatsara_reckoned_from`: `vikram` da el nombre del norte de la India, el samvatsara del Júpiter medio vigente en el Mesha sankranti de ese año; `shaka` da el nombre del sur de la India, ligado al año lunar. Valor por defecto: `vikram`; el endpoint padre lo exige y devuelve un error si falta.
Campos de la solicitud
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.
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
timezone_as_float
number (double)
obligatorio
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
keys
array
opcional
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.