POST/api/astro/samvatsara/1 credit

Rulers of the Hindu year

The King, the Minister and eight more lords of the Hindu year. At the start of the samvatsara the chart is cast and particular planets take particular offices for the twelve months that follow: the King over the year as a whole, the Minister over governance, and lords over rainfall, wealth, grain, juices, water, fruit, crops and defence. This is the frame almanac publishers write their annual predictions inside. Each office comes back with what it governs, so `neersesha_of_year` reads as 'Lord of Water, governs rivers and water supply'. Returned with the moment the year begins and the samvatsara's vaahana. Needs only a year — there is no birth chart in mundane astrology, and the answer does not change with the place you ask from.

https://yogataraapi.prahlad.app/api/astro/samvatsara/

Test Request

Authentication

Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Request fields

Field	Type	Required	Notes
date_time	string (date-time)	required	The moment to calculate for, ISO 8601. ALWAYS include an offset or a trailing Z - a value with no zone is read as Asia/Kolkata (UTC+05:30), not UTC, and can return the previous day's result with a 200. '2026-09-01T06:00:00Z' and '2026-09-01 06:00:00' are different instants and give different answers.
latitude	number (double)	required	Latitude of the place, in decimal degrees. Positive is north, negative is south. Example: 26.9124 for Jaipur, 40.7128 for New York. Minutes and seconds are not accepted - convert first. min -90 · max 90
longitude	number (double)	required	Longitude of the place, in decimal degrees. Positive is east, negative is west. Example: 75.7873 for Jaipur, -74.0060 for New York. Note the sign: a missing minus puts New York in China. min -180 · max 180
timezone_as_float	number (double)	required	UTC offset of the place, in hours, as a decimal. Example: 5.5 for India (UTC+05:30), -5 for New York in winter, 5.75 for Nepal. This is NOT validated against date_time - if the two disagree you get a successful response for the wrong moment, so derive both from the same source. Use the offset in force on that date, not today's: a summer birth in a country with daylight saving needs the summer offset. min -12 · max 14
year	integer	required	Year of birth as a number, e.g. 1990. Four digits.
keys	array	optional	Which calculations to return, as a list of names. See the key table for this endpoint; an unrecognised name rejects the whole request. One call costs one credit however many keys you ask for, so request everything you need at once rather than making several calls.
nakshatra	string	optional	Only read by /nakshatra-chakras/; ignored elsewhere.

Example request

curl -X POST https://yogataraapi.prahlad.app/api/astro/samvatsara/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2025,"date_time":"2025-02-13T05:00:37Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

Response

{
  "data": {
    "year": 2025,
    "year_begins": "2025-03-29T06:24:43+05:30",
    "vaahana": "Elephant/Frog",
    "cabinet": [
      {
        "office": "King (Raja)",
        "key": "king_of_year",
        "governs": "the year as a whole",
        "planet": "Venus"
      },
      {
        "office": "Minister (Mantri)",
        "key": "mantri_of_year",
        "governs": "governance and counsel",
        "planet": "Saturn"
      },
      {
        "office": "Lord of Clouds (Meghesha)",
        "key": "meghesha_of_year",
        "governs": "rainfall",
        "planet": "Saturn"
      },
      {
        "office": "Lord of Wealth (Dhanesha)",
        "key": "dhanesha_of_year",
        "governs": "money and trade",
        "planet": "Moon"
      },
      {
        "office": "Lord of Grain (Dhaanyesha)",
        "key": "dhaanyesha_of_year",
        "governs": "the grain harvest",
        "planet": "Sun"
      },
      {
        "office": "Lord of Juices (Rasesha)",
        "key": "rasesha_of_year",
        "governs": "sap, juices and liquids",
        "planet": "Jupiter"
      },
      {
        "office": "Lord of Water (Neeresha)",
        "key": "neersesha_of_year",
        "governs": "rivers and water supply",
        "planet": "Mars"
      },
      {
        "office": "Lord of Fruit (Phalesha)",
        "key": "phalesha_of_year",
        "governs": "fruit crops",
        "planet": "Jupiter"
      },
      {
        "office": "Lord of Crops (Sashyesha)",
        "key": "sashyesha_of_year",
        "governs": "standing crops",
        "planet": "Mars"
      },
      {
        "office": "Lord of Forts (Durgesha)",
        "key": "durgesha_of_year",
        "governs": "defence and strongholds",
        "planet": "Venus"
      }
    ],
    "das_adhikari": {
      "King": "Venus",
      "Minister": "Saturn",
      "Lord of Clouds": "Saturn",
      "Lord of Summer Crops": "Mars",
      "Lord of Defence": "Venus",
      "Lord of Treasury": "Moon",
      "Lord of Juicy Products": "Jupiter",
      "Lord of Food Grains": "Sun",
      "Lord of Metals": "Mars",
      "Lord of Fruits": "Jupiter",
      "Vehicle of Year": "Elephant/Frog"
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Captured from a real call using the exact request above. Results sit under data.

Errors

Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.