SEARCH ASTRO INSIGHT API DOCS
The Varshaphal Muntha API provides Varshaphal related calculations and insights based on Vedic Astrology principles. This endpoint is designed for astrology applications, report generation systems, horoscope platforms, and developer integrations requiring structured JSON responses and reliable REST API access.
https://json.astroinsightapi.com/api/v1/varshaphal/muntha
en
hi
ma
Methodology and astrological context for Varshaphal Muntha.
Returns the Muntha position for a given Varshaphal (Solar Return) year — one of the most significant and distinctive elements of the Tajika annual horoscope system. The Muntha is a sensitive point unique to Varshaphal analysis that advances one sign per year from the natal ascendant, and its house placement and planetary associations in the solar return chart are central to predicting the overall tone and key themes of the year ahead.
This endpoint accepts the individual's birth details, their current geographic location for the target year, and the desired Varshaphal year, then computes the Muntha — a progressed point that moves one zodiac sign per year starting from the natal ascendant degree. The endpoint calculates the Muntha's exact position in the Varshaphal chart, determines which house it occupies, identifies the planets aspecting or conjoining it, and assesses its overall strength and condition for the target year. The Muntha's house placement is considered one of the primary indicators of the year's general fortune and dominant life themes in the Tajika system.
The response includes detailed information about the Muntha for the target Varshaphal year:
Muntha position — the zodiac sign and degree the Muntha occupies in the target year's Varshaphal chart
House placement — which house of the Varshaphal chart the Muntha falls in, along with an interpretation of what that house placement signifies for the year
Muntha lord — the ruling planet of the sign the Muntha occupies, and that planet's condition and placement in the Varshaphal chart
Planetary aspects and conjunctions — which planets aspect or conjoin the Muntha, and whether those influences are benefic or malefic
Muntha strength assessment — an evaluation of the Muntha's overall strength and dignity based on its sign, house, and planetary associations
Year significance indicators — summary indicators of the Muntha's overall influence on the year, based on its house placement and the condition of its lord
Annual horoscope generation — computing the Muntha as a core component of a complete Varshaphal reading, providing the primary indicator of the year's overall fortune
Jyotish practitioners specializing in Varshaphal — accessing precise Muntha data and its house-based interpretation for client year-ahead consultations
Astrology platforms and apps — powering annual forecast features that highlight the Muntha's house placement as a key year-ahead indicator alongside other Varshaphal data
Year-specific predictive analysis — combining Muntha data with Varshaphal planetary positions, yogas, and dashas for a layered annual forecast
Educational tools — demonstrating the Muntha concept and its year-by-year progression through the houses as part of Tajika system instruction
Computes the Muntha's exact position for the target year based on its one-sign-per-year progression from the natal ascendant, providing degree-level precision rather than a simple sign assignment
Identifies the Muntha lord and evaluates its condition in the Varshaphal chart — a critical secondary step in Muntha analysis, as the lord's strength significantly modifies the Muntha's influence
Assesses planetary aspects and conjunctions to the Muntha, distinguishing between benefic and malefic influences that strengthen or weaken its positive potential for the year
Accepts both birth location and current location separately — birth data establishes the natal ascendant from which the Muntha progresses, while current latitude, longitude, and timezone determine the Varshaphal house framework
Accepts a target Varshaphal year (varshaphalYear) to compute the Muntha for any past, present, or future year, enabling historical review and multi-year planning
Supports multiple Ayanamsha systems (e.g., Lahiri, Raman, KP) via the X-Ayanamsha header for sidereal calculations aligned with the practitioner's tradition
Designed for localization — the Accept-Language header controls the language of descriptive and interpretive content in the response
Intended to be used alongside other Varshaphal endpoints (planets, houses, yogas, etc.) as a dedicated Muntha data layer within a complete annual horoscope analysis
Payload specifications for JSON request body.
| Parameter | Type | Description & Example |
|---|---|---|
|
day
Required
|
integer |
Day of birth (1–31).
Example:
15
|
|
month
Required
|
integer |
Month of birth (1–12).
Example:
9
|
|
year
Required
|
integer |
Year of birth (e.g., 1994).
Example:
1994
|
|
hour
Required
|
integer |
Hour of birth in 24-hour format (0–23).
Example:
12
|
|
min
Required
|
integer |
Minute of birth (0–59).
Example:
30
|
|
sec
Optional
|
integer |
Second of birth (0–59). Optional. If not provided, it is considered as 0.
Example:
30
|
|
lat
Required
|
float |
Latitude of the birth location.
Example:
28.6139
|
|
lon
Required
|
float |
Longitude of the birth location.
Example:
77.1025
|
|
tzone
Optional
|
float |
Timezone offset from UTC. Optional. If not provided, it is considered as 5.5 (IST).
Example:
5.5
|
|
varshaphalYear
Optional
|
integer |
Varshaphal year.
Example:
2025
|
|
cLat
Required
|
float |
Current Latitude of the birth location.
Example:
28.6139
|
|
cLon
Required
|
float |
Current Longitude of the birth location.
Example:
77.1025
|
|
cTzone
Optional
|
float |
Current Timezone offset from UTC. Optional. If not provided, it is considered as 5.5 (IST).
Example:
5.5
|
| Header Key | Value / Format | Description |
|---|---|---|
|
Authorization
Required
|
Basic {base64} |
Base64 encoded string of CLIENT_ID:CLIENT_SECRET. |
|
Content-Type
Required
|
application/json |
Specifies JSON payload format in request body. |
|
Accept-Language
Optional
|
en, hi, ta, te... |
Returns localized astrology output. Default: en |
|
X-Ayanamsha
Optional
|
lahiri, raman, krishnamurti... |
Ayanamsha system: lahiri, raman, fagan_bradley, usha_shashi, krishnamurti, djwhal_khul, yukteshwar, jn_bhasin, suryasiddhanta, aryabhata. Default: lahiri |
Explore complementary endpoints in this category.
Comprehensive developer guidance for Varshaphal Muntha.
The Varshaphal Muntha API provides authentic Varshaphal calculations based on Vedic astrology algorithms. It returns structured JSON data containing detailed planetary positions, house calculations, and astrological parameters suitable for Kundli apps, astrology websites, and developer applications.
The Varshaphal Muntha API requires standard Vedic birth details: day, month, year, hour, min, sec, latitude (lat), longitude (lon), and timezone (tzone). All parameters can be passed in the JSON request body.
Each calculation request to Varshaphal Muntha consumes 1 API credit. The endpoint delivers high performance with an average response time of ~89ms.
Authenticate using HTTP Basic Authentication by including your Base64 encoded client_id:client_secret credentials in the Authorization header (Authorization: Basic BASE64(client_id:client_secret)).
Yes! The API supports multiple languages including English, Hindi, Marathi. Pass your desired language code (e.g. 'hi' for Hindi, 'ta' for Tamil, 'en' for English) in the Accept-Language request header.
Supported Ayanamshas include NC Lahiri (Default), BV Raman, Krishnamurti (KP), Fagan Bradley, Usha Shashi, Djwhal Khul, Sri Yukteshwar, JN Bhasin, Surya Siddhanta, and Aryabhata. Specify your choice using the X-Ayanamsha header.
The API returns clean JSON UTF-8 output. Successful requests return HTTP 200 OK with the computed data payload. Parameter validation errors return HTTP 422 with actionable error messages.