SEARCH ASTRO INSIGHT API DOCS
The Varshaphal Saham Points 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/saham-points
en
hi
ma
Methodology and astrological context for Varshaphal Saham Points.
Returns the Saham (Arabic Parts / Lots) positions for a given Varshaphal (Solar Return) chart — a set of sensitive mathematical points unique to the Tajika annual horoscopy system that are derived from specific combinations of planetary and house cusp degrees. Saham points are among the most distinctive and practically important elements of Varshaphal analysis, each one representing a specific life domain or theme, and their house placements and planetary associations in the solar return chart are used to assess the prospects for that domain 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 positions of all major Saham points in the resulting solar return chart. Each Saham is calculated using a formula that combines the longitudes of two planets (or a planet and a house cusp) with the Varshaphal ascendant, producing a degree position that falls in a specific sign and house of the annual chart. The endpoint evaluates each Saham's house placement, identifies the planets aspecting or conjoining it, and assesses the condition of its dispositor — the planet ruling the sign the Saham occupies — to determine the overall strength and favorability of that life domain for the year.
The response provides a comprehensive set of Saham point data for the target Varshaphal year:
Saham point positions — the zodiac sign and degree of each Saham in the Varshaphal chart, covering all major Sahams recognized in the Tajika tradition (such as Punya Saham, Vidya Saham, Vivah Saham, Putra Saham, Mrityu Saham, Raja Saham, and others)
Saham name and life domain — the name of each Saham and the specific life area or theme it governs (e.g., fortune, education, marriage, children, career, health, travel)
House placement — which house of the Varshaphal chart each Saham falls in, along with an assessment of what that placement signifies for the corresponding life domain during the year
Dispositor identity and condition — the planet ruling the sign occupied by each Saham, and that planet's placement, strength, and condition in the Varshaphal chart, which directly modifies the Saham's effectiveness
Planetary aspects and conjunctions — which planets aspect or conjoin each Saham, and whether those influences are benefic or malefic, strengthening or weakening the Saham's positive potential
Saham strength assessment — an overall evaluation of each Saham's condition based on its house placement, dispositor strength, and planetary associations
Year significance indicators — summary indicators of the prospects for each Saham's life domain during the target year, based on the combined picture of placement, dispositor, and aspects
Domain-specific annual forecasting — using Saham points to assess the prospects for specific life areas (marriage, career, children, health, finances, travel, etc.) during the target Varshaphal year, going beyond the general year tone provided by Muntha and Varshesh
Jyotish practitioners specializing in Tajika — accessing precise Saham positions and their interpretive assessments as a core component of a complete Varshaphal reading, particularly for client questions about specific life domains
Astrology platforms and apps — powering life-domain-specific annual forecast features that display Saham-based assessments for each major area of life, enriching the annual horoscope with targeted predictions
Event timing refinement — combining Saham house placements with Muddha Dasha periods to identify not just which life domains are highlighted for the year but when during the year those themes are most likely to be activated
Muhurta and electional astrology — using Saham positions to identify favorable periods for initiating activities related to specific life domains (e.g., marriage, business ventures, travel) within the target year
Comparative year analysis — running the endpoint across multiple Varshaphal years to track how the Saham positions shift and which life domains are favored or challenged in different years
Computes all major Tajika Sahams in a single response, covering the full range of life domains recognized in the Tajika tradition rather than returning only a subset, providing a comprehensive annual life-domain map in one call
Evaluates each Saham's dispositor condition as a critical secondary step — since the dispositor's strength in the Varshaphal chart is the primary modifier of the Saham's effectiveness, this assessment is essential for accurate interpretation and is included automatically
Assesses planetary aspects and conjunctions to each Saham, distinguishing between benefic and malefic influences and quantifying their effect on the Saham's overall strength and favorability
Returns each Saham with its name, life domain label, and house placement together, making the output directly interpretable without requiring the practitioner to cross-reference Saham definitions separately
Accepts both birth location and current location separately — birth data establishes the natal planetary positions used in Saham formulas, while current latitude, longitude, and timezone determine the Varshaphal ascendant that anchors all Saham calculations
Accepts a target Varshaphal year (varshaphalYear) to compute Saham positions for any past, present, or future solar return year, enabling historical review and multi-year life-domain 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 Saham names, life domain labels, and all descriptive and interpretive content in the response
Serves as the life-domain specificity layer within a complete Varshaphal analysis, complementing the broader year-tone indicators (Muntha, Varshesh, yogas) with targeted assessments for individual areas of life, and intended to be used alongside timing endpoints (Muddha Dasha) for maximum predictive precision
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 Saham Points.
The Varshaphal Saham Points 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 Saham Points 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 Saham Points consumes 1 API credit. The endpoint delivers high performance with an average response time of ~37ms.
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.