🌍 Astrocartography API, 🔷 Human Design API and ✋ Palmistry API are now live. Ship them in your app today.

Varshaphal Details

The varshaphal_details API provides information about a person's yearly horoscope based on their birth date. The response includes details such as the year, age of the person, birth date, and details about different planetary positions and lords.
POSThttps://json.astrologyapi.com/v1/varshaphal_details

Authentication

x-astrologyapi-keystringrequired

API access token used to authenticate requests. Send your access token in this custom header.

Accept-Languagestring

Preferred language for the response content. Supported: English - en, Hindi - hi, Marathi - ma, Bengali - bn, Tamil - ta, Telugu - te, Malayalam - ml, Kannada - kn.

Body parameters

dayintrequired

Date of birth, eg: 10

monthintrequired

Month of birth, eg: 5

yearintrequired

Year of birth, eg: 1990

hourintrequired

Hour of birth, eg: 19

minintrequired

Minute of birth, eg: 55

latfloatrequired

Latitude, eg: 19.2056

lonfloatrequired

Longitude, eg: 25.2056

tzonefloatrequired

Timezone, eg: 5.5

varshaphal_yearintrequired

Varshphal year, eg: 1990

curl --location 'https://json.astrologyapi.com/v1/varshaphal_details' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "day": 10,
    "month": 5,
    "year": 1990,
    "hour": 19,
    "min": 55,
    "lat": 19.2056,
    "lon": 25.2056,
    "tzone": 5.5,
    "varshaphal_year": 1990
}'
Try it

Runs with sample data — no API key needed

{
  "varshaphala_year": 2001,
  "age_of_native": 1,
  "ayanamsha_name": "LAHIRI",
  "ayanamsha_degree": 23.8779,
  "varshaphala_timestamp": 993677784000,
  "native_birth_date": "27-06-2000 15:30:00",
  "varshaphala_date": "27-06-2001 21:36:24",
  "panchadhikari": {
    "muntha_lord": "Mars",
    "muntha_lord_id": 2,
    "birth_ascendant_lord": "Venus",
    "birth_ascendant_lord_id": 5,
    "year_ascendant_lord": "Saturn",
    "year_ascendant_lord_id": 6,
    "dinratri_lord": "Mercury",
    "trirashi_lord": "Mars"
  },
  "varshaphala_year_lord": "Mars",
  "varshaphala_muntha": {
    "muntha_sign": "Scorpio",
    "muntha_sign_lord": "Mars"
  }
}