Divisional charts (Vargas)

Compute any of the 21 classical divisional charts from D1 (Rasi) to D60 (Shashtyamsa) for a given chart.

GET /v1/vedic/charts/{chart_id}/divisional/{varga}

varga must be one of: D1, D2, D2_SUN_MOON, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D16, D20, D24, D27, D30, D40, D45, D60.

D9 uses the canonical Parashara navamsa sequence (fire signs start from Aries, earth from Capricorn, air from Libra, water from Cancer). Everything else uses the generic Saravali algorithm.

Example

curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/divisional/D9"

Response

{
  "varga": "D9",
  "chart_id": "01HKD…",
  "entries": [
    {"planet": "sun", "sign": "leo"},
    {"planet": "moon", "sign": "scorpio"},
    {"planet": "mars", "sign": "aries"},
    {"planet": "mercury", "sign": "gemini"},
    {"planet": "jupiter", "sign": "cancer"},
    {"planet": "venus", "sign": "libra"},
    {"planet": "saturn", "sign": "aquarius"},
    {"planet": "rahu", "sign": "virgo"},
    {"planet": "ketu", "sign": "pisces"},
    {"planet": "ascendant", "sign": "taurus"},
    {"planet": "midheaven", "sign": "capricorn"}
  ]
}

When to use which Varga

Varga	Classical meaning
D1	The Rasi chart itself — life as a whole.
D2 (Hora)	Wealth, livelihood.
D3 (Drekkana)	Siblings, courage.
D7 (Saptamsa)	Children, grandchildren.
D9 (Navamsa)	Marriage, dharma. The single most-used D-chart.
D10 (Dashamsa)	Career, public status.
D12 (Dwadashamsa)	Parents.
D16 (Shodashamsa)	Vehicles, comforts.
D20 (Vimshamsa)	Spiritual practice.
D24 (Chaturvimshamsa)	Education.
D27 (Bhamsa)	Strengths and weaknesses.
D30 (Trimshamsa)	Misfortunes.
D60 (Shashtyamsa)	Karmic results — fine-grained.

GET /v1/vedic/charts/{chart_id}/vargas/{varga}

The current single-varga endpoint (requires a Vedic chart). Same varga values and the same {varga, chart_id, entries} response as /divisional/{varga} above. Prefer this path; /divisional/{varga} remains as a legacy alias that also accepts Western charts.

GET /v1/vedic/charts/{chart_id}/vargas

The full core 16-varga set in one call.

{
  "chart_id": "01HKD…",
  "method_version": "v2",
  "vargas": [
    { "varga": "D1", "chart_id": "01HKD…", "entries": [ { "planet": "sun", "sign": "leo" } ] }
    /* …one DivisionalChartResponse per varga (D1, D2, D3, D4, D7, D9, D10,
          D12, D16, D20, D24, D27, D30, D40, D45, D60) */
  ],
  "features_used": [ { "source": "vargas", "version": "v2", "fields": ["entries"] } ]
}

Field	Type	Notes
vargas[]	DivisionalChart[]	One {varga, chart_id, entries} per chart in the core set.
method_version	string	Calculation method tag.
features_used[]	object	Provenance: {source, version, fields} per feature used.

Focused vargas — GET …/navamsa and GET …/dashamsa

Convenience endpoints for the two most-used divisional charts, each returning the varga plus the life topics it speaks to.

• GET /v1/vedic/charts/{chart_id}/navamsa — the D9, with focus_topics for marriage / dharma.
• GET /v1/vedic/charts/{chart_id}/dashamsa — the D10, with focus_topics for career / status.

{
  "chart_id": "01HKD…",
  "varga": "D9",
  "entries": [ { "planet": "sun", "sign": "leo" } ],
  "focus_topics": ["marriage", "dharma"],
  "features_used": [ { "source": "navamsa", "version": "v2", "fields": ["entries"] } ]
}

GET /v1/vedic/charts/{chart_id}/varga-strength

Own-sign and repeated-sign strength patterns for each planet across the core vargas — a quick read of vargottama / vimshopaka-style consistency.

{
  "chart_id": "01HKD…",
  "method_version": "v2",
  "vargas": ["D1", "D2", "D3", "D9", "D10", "D12", "D30", "D60"],
  "entries": [
    {
      "planet": "sun",
      "own_sign_count": 3,
      "dignity_name": "moolatrikona",
      "own_sign_vargas": ["D1", "D9", "D10"],
      "repeated_signs": [ { "sign": "leo", "count": 4 } ]
    }
  ],
  "features_used": [ { "source": "varga_strength", "version": "v2", "fields": ["entries"] } ]
}

Field (per entries[])	Type	Notes
planet	string
own_sign_count	int	How many core vargas place the planet in its own sign.
dignity_name	string | null	Best dignity reached (e.g. moolatrikona).
own_sign_vargas	string[]	Which vargas those are.
repeated_signs[]	object	{sign, count} — signs the planet repeats across vargas (vargottama signal).

Every endpoint above requires scope charts:read.