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.

Endpoint

POST /v1/astro/varshaphal

Request parameters

Field	Type	Required	Description
location	string | null	No	City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.
name	string	No	Person name associated with the birth record
date	string	Yes	Birth date in YYYY-MM-DD format
time	string | null	No	Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.
latitude	number | null	No	Latitude. Required if location not provided.
longitude	number | null	No	Longitude. Required if location not provided.
timezone	string | null	No	IANA timezone. Required if location not provided.
ayanamsa	string	No	Sidereal ayanamsa mode used in calculations
target_year	integer	Yes	Year for solar return e.g. 2026

Example request

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);

Example response

{
  "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
  }
}

Response fields

Field	Type	Description
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

Code	Description	Reference
authentication_failed	Missing or invalid API key.	authentication_failed
ephemeris_unavailable	Upstream ephemeris service error.	ephemeris_unavailable
insufficient_tier	API key tier does not include this endpoint.	insufficient_tier
internal_error	Unexpected server error.	internal_error
ip_rate_limit_exceeded	Too many requests in a short window.	ip_rate_limit_exceeded
payload_too_large	Request body exceeds the size limit.	payload_too_large
resource_not_found	Referenced resource was not found.	resource_not_found
validation_error	Request body failed schema validation.	validation_error

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