Skip to main content
POST/v1/astro/divisional

Divisional charts — Varga

Computes all 16 Vedic divisional charts (Varga charts) for a given birth date, time, and location. What are divisional charts? In Vedic astrology, the birth chart (D1) is divided into progressively finer subdivisions to reveal different areas of life. Each divisional chart isolates a specific domain — the D9 Navamsha reveals spouse and dharma, the D10 Dashamsha reveals career, the D60 Shashtyamsha is the most subtle and reveals karmic residue from past lives. The 16 charts returned: - D1 — Rashi (natal chart) - D2 — Hora (wealth) - D3 — Drekkana (siblings) - D4 — Chaturthamsha (property) - D7 — Saptamsha (children) - D9 — Navamsha (spouse, dharma) — the most consulted divisional chart - D10 — Dashamsha (career) - D12 — Dwadashamsha (parents) - D16 — Shodashamsha (vehicles) - D20 — Vimshamsha (spirituality) - D24 — Chaturvimshamsha (education) - D27 — Bhamsha (vitality) - D30 — Trimshamsha (misfortunes) - D40 — Khavedamsha (auspicious effects) - D45 — Akshavedamsha (all life matters) - D60 — Shashtyamsha (subtle karmic residue) Each chart shows every planet's sign placement within that divisional subdivision, with its dignity there (exalted, debilitated, own sign, friendly, neutral or enemy) and whether it is vargottama (same sign as in D1). When the birth time is known, each chart also has its own lagna, every planet's whole-sign house from that lagna, and a houses table per chart (sign, lord and occupants of each house). Use the D9 alongside the D1 for most interpretive work. Ayanamsa: All positions are sidereal. Default is Lahiri. Also known as Varga charts or Amsha charts. Only the requested chart_type is returned. To get all sixteen charts, omit the chart_type parameter.

Request parameters​

locationoptional
string | null
City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.
nameoptional
string
Person name associated with the birth record
daterequired
string
Birth date in YYYY-MM-DD format
timeoptional
string | null
Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.
latitudeoptional
number | null
Latitude. Required if location not provided.
longitudeoptional
number | null
Longitude. Required if location not provided.
timezoneoptional
string | null
IANA timezone. Required if location not provided.
ayanamsaoptional
string
Sidereal ayanamsa mode used in calculations
chart_typeoptional
string | null
Return only this divisional chart (e.g. D9). Omit for all standard charts.

Response fields​

success
boolean
True if the request succeeded
message
string
Human-readable status message
data
object
data.D1
object
Rashi — the natal chart itself
data.D2
object
Hora — wealth and financial potential
data.D3
object
Drekkana — siblings and courage
data.D4
object
Chaturthamsha — property and fixed assets
data.D7
object
Saptamsha — children and creative output
data.D9
object
Navamsha — spouse, dharma, and deeper soul purpose. A primary divisional chart.
data.D10
object
Dashamsha — career and professional life
data.D12
object
Dwadashamsha — parents and ancestral karma
data.D16
object
Shodashamsha — vehicles and comforts
data.D20
object
Vimshamsha — spiritual life and upasana
data.D24
object
Chaturvimshamsha — education and learning
data.D27
object
Bhamsha — strength and physical vitality
data.D30
object
Trimshamsha — misfortunes and evils
data.D40
object
Khavedamsha — auspicious and inauspicious effects
data.D45
object
Akshavedamsha — all matters of life
data.D60
object
Shashtyamsha — all matters, most subtle divisional chart
data.houses
object | null
Whole-sign houses of each varga chart, counted from that chart's lagna: {chart: [{house, sign, sign_num, lord, planets}]}. Present only when the birth time is known. Each planet entry in a chart also carries house, dignity (exalted, debilitated, own_sign, friendly, neutral, enemy; the seven classical planets) and is_vargottama (same sign as in D1).
data.birth_time_provided
boolean
Whether a precise birth time was provided. False when birth time was not supplied or treated as unknown — calculations using this field will have lagna-dependent accuracy limits.

Errors​

Missing or invalid API key.
Upstream ephemeris service error.
Reserved; product endpoints are not feature-gated by plan (quota differs by tier).
Unexpected server error.
Too many requests in a short window.
Request body exceeds the size limit.
Referenced resource was not found.
Request body failed schema validation.