SEARCH ASTRO INSIGHT API DOCS
The Varshaphal Harsha Bala 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/harsha-bala
en
hi
ma
Methodology and astrological context for Varshaphal Harsha Bala.
Returns the Harsha Bala (Happiness Strength) scores for all planets in a Varshaphal (Solar Return) chart — a Tajika-specific strength metric that measures each planet's sense of ease, comfort, and positivity within the annual horoscope framework. Harsha Bala is one of the supplementary strength assessments used in Varshaphal analysis to refine planetary potency evaluations beyond the primary Panchavargeeya Bala, helping practitioners identify which planets are operating in a state of natural harmony and which are under strain during the target year.
This endpoint accepts the individual's birth details, their current geographic location for the target year, and the desired Varshaphal year, then computes the Harsha Bala for each planet in the resulting solar return chart. Harsha Bala is derived from a planet's placement relative to specific house positions and sign conditions that are considered inherently favorable or unfavorable in the Tajika system. A planet with high Harsha Bala is considered to be in a state of contentment and capable of expressing its significations positively, while a planet with low Harsha Bala may struggle to deliver favorable results even if other strength indicators are present.
The response provides a complete Harsha Bala assessment for every planet in the Varshaphal chart:
Harsha Bala score — the numerical strength value for each planet, expressed in Rupas or a normalized unit consistent with the Tajika strength system
Strength classification — a qualitative assessment of each planet's Harsha Bala level (e.g., strong, moderate, weak) based on its score relative to established Tajika thresholds
Contributing factors — the specific positional and conditional factors that contribute to each planet's Harsha Bala score, such as house placement, sign condition, and relationship to benefic or malefic influences
Planet identity and position — the zodiac sign, degree, and house placement of each planet in the Varshaphal chart, providing context for the strength scores
Comparative significance — indicators of how each planet's Harsha Bala interacts with its other strength measures to give a more nuanced picture of its overall annual potency
Refined annual horoscope analysis — using Harsha Bala alongside Panchavargeeya Bala to build a more complete and nuanced picture of each planet's capacity to deliver results during the target year
Jyotish practitioners specializing in Tajika — accessing Harsha Bala data to identify planets that are technically strong by composite score but may still be hampered by low happiness strength, or vice versa
Astrology platforms and apps — incorporating Harsha Bala as an additional strength layer in annual forecast features, particularly for platforms targeting advanced Tajika practitioners who expect comprehensive strength breakdowns
Planetary period (Mudda dasha) interpretation — combining Harsha Bala with dasha lord analysis to assess whether the active dasha lord is in a state of ease or discomfort during its period, refining predictions for that sub-period
Yoga quality assessment — evaluating whether the planets forming Tajika yogas in the Varshaphal chart have sufficient Harsha Bala to express those yogas in a positive and harmonious manner
Educational tools — demonstrating the Harsha Bala concept and its role as a supplementary strength metric within the broader Tajika annual horoscopy system
Computes Harsha Bala as a distinct strength metric separate from Panchavargeeya Bala, providing an additional evaluative dimension that captures a planet's positional comfort and ease within the Varshaphal chart framework
Applies Tajika-specific thresholds to classify each planet's Harsha Bala score qualitatively, giving practitioners an immediate read on planetary happiness without manual score interpretation
Returns contributing factor details that explain why each planet received its particular score, making the output transparent and useful for practitioners who want to understand the reasoning behind the assessment rather than just the result
Accepts both birth location and current location separately — birth data establishes the natal reference point, while current latitude, longitude, and timezone determine the Varshaphal ascendant and house framework that underpins the placement-based Harsha Bala calculation
Accepts a target Varshaphal year (varshaphalYear) to compute Harsha Bala for any past, present, or future solar return 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 classificatory content in the response
Intended to be used as a complementary strength layer alongside other Varshaphal endpoints (Panchavargeeya Bala, planets, Muntha, yogas, etc.), enriching the overall planetary strength picture rather than replacing the primary strength assessment
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 Harsha Bala.
The Varshaphal Harsha Bala 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 Harsha Bala 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 Harsha Bala consumes 1 API credit. The endpoint delivers high performance with an average response time of ~55ms.
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.