Varshaphal Saham Points API

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.

What This API Does

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.

Data Returned

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

Main Use Cases

• 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

Key Functionality

• 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