logo

Annual Horoscope API

Varshphal is also known as a Vedic solar return.

Our Varshphal APIs are comprehensive and covers a list of Varshphal features such as varshphal chart, muntha details, panchadhikari, lord of the year, saham details, Varshphal Yogas and monthly panchang.

You also get APIs for Varshphal interpretation as well for given Varshphal year.

Sign up for freeSchedule a demo
varshphal

Varshphal Chart and Positions

Get the snapshot of planetary positions for the period when the Sun's transit is in the same sign again. The API draws a chart along with planet positions.

image

Muntha and Muntha Lord Report

Learn more about the progressed ascendant that moves to each sign yearly. The API provides effects on Muntha and Muntha Lord on a kundli.

Panchvargiya Balam

Reveal the strength of planets in the varshaphal chart with the API. It is calculated based mainly on five factors.

Mudda Dasha API

Know the planetary periods for the entire year with the Mudda Dasha API. The API provides information about Purna Dasha and Rikta Dasha for a year.

image

Harsh Balam

The Harsha Balam API determines the strength of planets based on their comfortable position. Integrate the API to know the planet's comfort level until the next birthday.

image

Saham Points

The Saham points API provides the special points that signify important events in life. Know the Saham Points for Kundli that will be crucial for the year.

image

Varshphal Yoga

Know the different yogas formed for the entire year with this API. These Varshalphal yogas help to gauge the direction of focus for the entire year.

image

What the Varshphal API gives you

Varshphal, also written Varshaphal, is the Vedic annual horoscope. It is cast for the moment the Sun returns to the place it held at birth. That is why people also call it a Vedic solar return.

Send us the birth details and the varshaphal_year you want. We return the year chart, the year lord, the muntha, planet strengths, sahams and the short dashas for that year. One set of inputs covers the whole year.

  • Year details

    The Varshphal date and time, the age, the year lord, and the five office holders called panchadhikari.

  • Muntha

    The muntha sign and its lord. Muntha moves one sign each year from the birth ascendant.

  • Charts

    The year chart and its planet positions, plus a chart for each month of the year.

  • Planet strength

    Harsha bala and panchavargeeya bala, two ways to score how strong each planet is that year.

  • Mudda dasha

    The short planet periods inside one year, with start and end dates.

  • Sahams and yogas

    Saham points such as Punya and Vidya, and Varshphal yogas such as Ithasala, each marked as happening or not.

Varshphal endpoints and sample responses

Each call is a POST with the birth fields and varshaphal_year. The birth fields are day, month, year, hour, min, lat, lon and tzone. These samples are trimmed from our docs.

Base URL: https://json.astrologyapi.com/v1

POST/varshaphal_details

Year summary

The year lord, the muntha and the panchadhikari lords for the year you chose. The full response also names the ayanamsha used.

1{
2  "varshaphala_year": 2001,
3  "age_of_native": 1,
4  "varshaphala_date": "27-06-2001 21:36:24",
5  "panchadhikari": {
6    "muntha_lord": "Mars",
7    "birth_ascendant_lord": "Venus",
8    "year_ascendant_lord": "Saturn",
9    "dinratri_lord": "Mercury",
10    "trirashi_lord": "Mars"
11  },
12  "varshaphala_year_lord": "Mars",
13  "varshaphala_muntha": {"muntha_sign": "Scorpio", "muntha_sign_lord": "Mars"}
14}
Read the /varshaphal_details reference →
POST/varshaphal_mudda_dasha

Mudda dasha

Nine short planet periods across the year. duration is the length of each period in days.

1[
2  {
3    "planet": "SUN",
4    "duration": 18,
5    "dasha_start": "3-2-2017,12:37:41",
6    "dasha_end": "21-2-2017,18:55:41"
7  },
8  {
9    "planet": "MOON",
10    "duration": 30,
11    "dasha_start": "21-2-2017,18:55:41",
12    "dasha_end": "24-3-2017,5:25:41"
13  },
14  {
15    "planet": "MARS",
16    "duration": 21,
17    "dasha_start": "24-3-2017,5:25:41",
18    "dasha_end": "14-4-2017,12:46:41"
19  }
20]
Read the /varshaphal_mudda_dasha reference →
POST/varshaphal_harsha_bala

Harsha bala

Four strength scores and a total. Each array holds one value for each of the seven planets.

1{
2  "stana_bala": [0, 0, 0, 0, 0, 0, 0],
3  "ucchaswachetri_bala": [0, 0, 0, 0, 0, 5, 0],
4  "gender_bala": [5, 5, 5, 5, 5, 0, 5],
5  "dinratri_bala": [5, 0, 5, 0, 5, 0, 0],
6  "total_bala": [10, 5, 10, 5, 10, 5, 5]
7}
Read the /varshaphal_harsha_bala reference →
POST/varshaphal_saham_points

Saham points

Each saham with its name and degree. Sahams are sensitive points for themes such as merit (Punya) and learning (Vidya).

1[
2  {"saham_id": 1, "saham_name": "Punya", "saham_degree": 242.6899},
3  {"saham_id": 2, "saham_name": "Vidya", "saham_degree": 20.482},
4  {"saham_id": 3, "saham_name": "Yasas", "saham_degree": 116.561},
5  {"saham_id": 4, "saham_name": "Mitra", "saham_degree": 279.7386}
6]
Read the /varshaphal_saham_points reference →

Who uses Varshphal data

More than 3,000+ businesses use AstrologyAPI. A yearly reading gives users a reason to come back each birthday.

Birthday features

Send a yearly report near each user’s birthday, as JSON on screen or as a PDF.

Kundli and Varshphal PDFs →

Consultation apps

Give the astrologer the year chart, muntha and mudda dasha before a yearly session.

Kundli API →

Content and media

Build a year ahead page for each user from real chart data.

How to build an astrology app →

Users who know Western astrology

People who know solar returns can see the Vedic version next to it.

Vedic vs Western astrology →

Docs and guides

The reference has every Varshphal field. The guides explain the inputs behind the year chart.

Varshphal API FAQ

What is Varshphal?

Varshphal is the Vedic annual horoscope. It is drawn for the moment the Sun comes back to its birth position in a given year. Astrologers read it for the themes of that one year of life.

How do I choose the year?

Send the varshaphal_year field along with the birth details. The response gives the exact Varshphal date and time for that year, and the age of the person.

What is muntha?

Muntha is a point that starts at the birth ascendant and moves one sign each year. Astrologers look at its sign and its lord when they read the year. varshaphal_details returns both.

What is mudda dasha?

A dasha is a period ruled by one planet. Mudda dasha fits the nine planet periods inside a single year. We return each planet, its length in days, and its start and end time.

Can I get a Varshphal PDF?

Yes. varshphal_horoscope_pdf creates a branded annual report from the same birth details and year. It returns a pdf_url that you can share with the user.

Which languages can the text come back in?

All Varshphal JSON endpoints support English, Hindi, Marathi, Bengali, Tamil, Telugu, Malayalam and Kannada. The PDF report is in English. A free account with 150 credits lets you test each one.

Request a free demo

Do you want to see how AstrologyAPI works? We’d love to show you.

Products
Astrology APIPDF APIHoroscope APIGeo Location APIAstroPagesAstrocartography APIHuman Design API
Astro AI
Astro-Chat APIPalmistry APIFace Reading APIVastu APIAudio Reports APIMCP Servers
Solutions
Vedic AstrologyWestern AstrologyHoroscopeNumerologyTarot Readings
Use Cases
Astrology AppsMatrimonial/DatingJewellery & GemstonesMedia and EntertainmentUtility and Lifestyle
Developers
Get Started GuideAPI ReferenceGuides & TutorialsBlogDownload SDKPostman CollectionWordPress Plugins
More Links
PricingAbout UsContact UsSchedule a DemoPrivacy PolicyTerms of UseRefund and Cancellation
astrology api logo© 2026 AstrologyAPI. All rights reserved.
facebooktwitter