POST/v1/astro/varshaphal

Varshaphal — Solar Return Chart

Computes the Varshaphal (annual horoscope) for a given year. Finds the exact moment when the Sun returns to its natal longitude, computes all planet positions at that moment, and returns Muntha (progressed ascendant) and Varsha Lord (year lord). Request JSON follows BirthInput plus target_year: name, date (YYYY-MM-DD), time (HH:MM, required), either location or latitude/longitude/timezone, ayanamsa.

Request parameters

locationoptional

string | null

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

nameoptional

string

Person name associated with the birth record

daterequired

string

Birth date in YYYY-MM-DD format

timeoptional

string | null

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.

latitudeoptional

number | null

Latitude. Required if location not provided.

longitudeoptional

number | null

Longitude. Required if location not provided.

timezoneoptional

string | null

IANA timezone. Required if location not provided.

ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

target_yearrequired

integer

Year for solar return e.g. 2026

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.target_year

integer

data.ayanamsa

string

data.solar_return_utc

string

data.solar_return_jd

number

data.natal_sun_longitude

number

data.natal_lagna

string

data.natal_lagna_index

integer

data.year_lord

string

data.muntha

object

data.muntha.rashi_index

integer

data.muntha.rashi

string

data.muntha.age_years

integer

data.muntha.muntha_lord

string | null

data.planets

object

data.varshaphal_ascendant_longitude

number | null

Sidereal ascendant longitude at solar return (degrees).

data.varshaphal_ascendant_sign

string | null

Sanskrit sign name of the Varshaphal ascendant.

data.varshaphal_ascendant_sign_index

integer | null

Sign index 0-11 of the Varshaphal ascendant.

data.varsha_pati

object

data.varsha_pati.planet

string

data.varsha_pati.role

string

data.varsha_pati.pancha_vargeeya_bala

number

data.varsha_pati.kshetra_bala

number

data.varsha_pati.uchcha_bala

number

data.varsha_pati.election_used_strongest_without_aspect

boolean

data.pancha_adhikaris

array[object]

data.pancha_vargeeya_bala

object

data.tajika_aspects

array[object]

data.tajika_planet_pairs

array[object]

Errors

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

API key tier does not include this endpoint.

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

• Gochar — Transit Analysis
• Muhurta — Auspicious Timing
• Personal Nakshatra Prediction (Tarabala)
• Planetary transits — Gochar
• Prashna (Horary Chart)
• Varshaphal — Harsha Bala
• Varshaphal — Tajika Saham Points

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/astro/varshaphal" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1985-11-12","time":"06:45","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata","target_year":2026}'

Python

import asterwise
from asterwise.api.astrology_api import AstrologyApi
from asterwise.models.varshaphal_request import VarshaphalRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = VarshaphalRequest(
    date="1985-11-12",
    time="06:45",
    latitude=19.076,
    longitude=72.8777,
    timezone="Asia/Kolkata",
    target_year=2026,
)

with asterwise.ApiClient(configuration) as client:
    api = AstrologyApi(client)
    result = api.varshaphal(varshaphal_request=request)
    print(result)

TypeScript

import { createClient, createConfig, varshaphal } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await varshaphal({
  client,
  body: {
      "date": "1985-11-12",
      "time": "06:45",
      "latitude": 19.076,
      "longitude": 72.8777,
      "timezone": "Asia/Kolkata",
      "target_year": 2026
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "target_year": 2026,
    "ayanamsa": "lahiri",
    "solar_return_utc": "2026-11-12T13:22:00Z",
    "solar_return_jd": 2461357.057399,
    "natal_sun_longitude": 205.9371,
    "natal_lagna": "Tula",
    "natal_lagna_index": 6,
    "year_lord": "Jupiter",
    "muntha": {
      "rashi_index": 11,
      "rashi": "Meena",
      "age_years": 41,
      "muntha_lord": "Jupiter"
    },
    "planets": {
      "Sun": {
        "longitude": 205.9371,
        "rashi_index": 6,
        "rashi": "Tula",
        "degree": 25.9371,
        "is_retrograde": false,
        "speed": 1.006075
      },
      "Moon": {
        "longitude": 242.2612,
        "rashi_index": 8,
        "rashi": "Dhanu",
        "degree": 2.2612,
        "is_retrograde": false,
        "speed": 11.899805
      },
      "Mars": {
        "longitude": 119.9725,
        "rashi_index": 3,
        "rashi": "Karka",
        "degree": 29.9725,
        "is_retrograde": false,
        "speed": 0.461201
      },
      "Mercury": {
        "longitude": 190.9144,
        "rashi_index": 6,
        "rashi": "Tula",
        "degree": 10.9144,
        "is_retrograde": true,
        "speed": -0.210651
      },
      "Jupiter": {
        "longitude": 121.3298,
        "rashi_index": 4,
        "rashi": "Simha",
        "degree": 1.3298,
        "is_retrograde": false,
        "speed": 0.09251
      },
      "Venus": {
        "longitude": 178.6722,
        "rashi_index": 5,
        "rashi": "Kanya",
        "degree": 28.6722,
        "is_retrograde": true,
        "speed": -0.05931
      },
      "Saturn": {
        "longitude": 344.4058,
        "rashi_index": 11,
        "rashi": "Meena",
        "degree": 14.4058,
        "is_retrograde": true,
        "speed": -0.04816
      },
      "Rahu": {
        "longitude": 301.2269,
        "rashi_index": 10,
        "rashi": "Kumbha",
        "degree": 1.2269,
        "is_retrograde": true,
        "speed": -0.052992
      },
      "Ketu": {
        "longitude": 121.2269,
        "rashi_index": 4,
        "rashi": "Simha",
        "degree": 1.2269,
        "is_retrograde": false,
        "speed": 0.052992
      }
    },
    "varshaphal_ascendant_longitude": 40.619287,
    "varsha_pati": {
      "planet": "Jupiter",
      "role": "muntha_pati",
      "pancha_vargeeya_bala": 39.5745,
      "kshetra_bala": 22.5,
      "uchcha_bala": 17.0745,
      "election_used_strongest_without_aspect": true
    },
    "pancha_adhikaris": [
      {
        "role": "muntha_pati",
        "planet": "Jupiter",
        "pancha_vargeeya_bala": 39.5745,
        "kshetra_bala": 22.5,
        "uchcha_bala": 17.0745,
        "hadda_bala": 0.0,
        "dreshkana_bala": 0.0,
        "navamsa_bala": 0.0,
        "pending_components_note": "Hadda/Dreshkana/Navamsa set to 0 [External]",
        "aspects_ascendant": false,
        "tajika_aspect_angles_matched": [],
        "separation_from_asc_deg": 80.7105
      },
      {
        "role": "janma_lagna_pati",
        "planet": "Venus",
        "pancha_vargeeya_bala": 15.1858,
        "kshetra_bala": 15.0,
        "uchcha_bala": 0.1858,
        "hadda_bala": 0.0,
        "dreshkana_bala": 0.0,
        "navamsa_bala": 0.0,
        "pending_components_note": "Hadda/Dreshkana/Navamsa set to 0 [External]",
        "aspects_ascendant": false,
        "tajika_aspect_angles_matched": [],
        "separation_from_asc_deg": 138.0529
      },
      "... and 3 more items"
    ],
    "pancha_vargeeya_bala": {
      "muntha_pati": 39.5745,
      "janma_lagna_pati": 15.1858,
      "varsha_lagna_pati": 15.1858,
      "tri_rasi_pati": 15.1858,
      "ratri_pati": 39.5745
    },
    "tajika_aspects": [
      {
        "planet": "Jupiter",
        "role": "muntha_pati",
        "separation_from_asc_deg": 80.7105,
        "matched_standard_angles": [],
        "aspects_ascendant": false
      },
      {
        "planet": "Venus",
        "role": "janma_lagna_pati",
        "separation_from_asc_deg": 138.0529,
        "matched_standard_angles": [],
        "aspects_ascendant": false
      },
      "... and 3 more items"
    ],
    "tajika_planet_pairs": [
      {
        "planet_a": "Sun",
        "planet_b": "Mars",
        "house_a": 6,
        "house_b": 3,
        "diff_ab": 10,
        "diff_ba": 4,
        "aspect_ab": "vikrama",
        "aspect_ba": "vikrama",
        "is_ithsala": true,
        "is_musaripha": false,
        "faster_planet": "Sun",
        "orb_degrees": 214.0354
      },
      {
        "planet_a": "Sun",
        "planet_b": "Jupiter",
        "house_a": 6,
        "house_b": 3,
        "diff_ab": 10,
        "diff_ba": 4,
        "aspect_ab": "vikrama",
        "aspect_ba": "vikrama",
        "is_ithsala": true,
        "is_musaripha": false,
        "faster_planet": "Sun",
        "orb_degrees": 215.3927
      },
      "... and 24 more items"
    ],
    "varshaphal_ascendant_sign": "Vrishabha",
    "varshaphal_ascendant_sign_index": 1
  }
}