Back to Docs

Divisional Charts

Divisional Charts

POST/api/v2/vedic/vargas

Calculate Vedic divisional charts from birth details, with ascendant, planetary placements, and houses for each requested division.

Authentication: send x-api-key.

Full URL

https://api.freeastroapi.com/api/v2/vedic/vargas
Safe retries with Idempotency-Key

Authenticated, billable astrology POST requests accept the optional header Idempotency-Key: <client-generated unique operation key>. Reuse the same key only when retrying the exact same method, path, query string, and JSON body after a timeout or network failure.

A completed replay returns the first response with Idempotency-Replayed: true, does not rerun the calculation, and does not consume extra quota. Keys are retained for about 24 hours.

Reusing a key with a changed request returns 409 idempotency_key_reused. A duplicate while the first request is still running returns 409 request_in_progress with Retry-After.

What It Returns

Requested charts are returned under vargas, keyed by division label (D1, D4, D9, etc.). Each chart includes ascendant, planets, houses, row sign ids, and calibration flags. Use the divisions parameter to select one or more supported charts.

Example Request

curl -X POST "https://api.freeastroapi.com/api/v2/vedic/vargas" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "year": 1997,
  "month": 9,
  "day": 22,
  "hour": 23,
  "minute": 25,
  "city": "Mumbai",
  "lat": 19.391928,
  "lng": 72.839732,
  "tz_str": "Asia/Kolkata",
  "ayanamsha": "lahiri",
  "house_system": "whole_sign",
  "node_type": "mean",
  "divisions": [
    1,
    4,
    9
  ]
}'

Request Parameters

Provide either city or both lat and lng. Coordinates are recommended for stable production results.

Field
year
Type
integer
Required
Yes
Description
Birth year.
Field
month
Type
integer
Required
Yes
Description
Birth month (1-12).
Field
day
Type
integer
Required
Yes
Description
Birth day.
Field
hour
Type
integer
Required
Yes
Description
Birth hour (0-23).
Field
minute
Type
integer
Required
Yes
Description
Birth minute (0-59).
Field
city
Type
string
Required
No
Description
Birth city. Optional when lat/lng are provided.
Field
lat
Type
float
Required
No
Description
Birth latitude. Recommended for production.
Field
lng
Type
float
Required
No
Description
Birth longitude. Recommended for production.
Field
tz_str
Type
string
Required
No
Description
Optional timezone override such as Asia/Kolkata, Europe/London, AUTO, or LMT. Defaults to AUTO when omitted.
Field
ayanamsha
Type
string
Required
No
Description
Vedic ayanamsha. Default is lahiri.
Field
house_system
Type
string
Required
No
Description
House system. Default is whole_sign.
Field
node_type
Type
string
Required
No
Description
Lunar node type: mean or true.
Field
divisions
Type
array[number]
Required
No
Description
Supported divisions: [1, 2, 3, 4, 5, 7, 9, 10, 12, 16, 20, 24, 27, 30, 40, 45, 60]. Entries are integers. Defaults to [1, 2, 3, 7, 9, 10, 12, 30]. Divisions outside this default selection must be requested explicitly. D5 is formula-supported; the other listed divisions are calibrated.

Response Shape

Field
vargas
Type
object
Required
n/a
Description
Requested divisional charts keyed by division label.
Field
vargas.D*.ascendant
Type
object
Required
n/a
Description
Divisional ascendant sign, degree where available, and house.
Field
vargas.D*.planets
Type
array
Required
n/a
Description
Divisional planet sign and house placements.
Field
vargas.D*.row_sign_ids
Type
object
Required
n/a
Description
AstroSage-style row sign ids used for table display.
Field
metadata
Type
object
Required
n/a
Description
Requested, supported, and calibrated divisions plus calculation settings.

Real Request Example

This request was captured from the live production endpoint and is the same payload used in the code tabs.

{
  "year": 1997,
  "month": 9,
  "day": 22,
  "hour": 23,
  "minute": 25,
  "city": "Mumbai",
  "lat": 19.391928,
  "lng": 72.839732,
  "tz_str": "Asia/Kolkata",
  "ayanamsha": "lahiri",
  "house_system": "whole_sign",
  "node_type": "mean",
  "divisions": [
    1,
    4,
    9
  ]
}

Real Response Example

V2

This is a real production response for the example payload. Large arrays are intentionally shown as returned by the API.

{
  "vargas": {
    "D1": {
      "division": 1,
      "name": "Rashi",
      "calibrated": true,
      "house_basis": "whole_sign",
      "ascendant": {
        "degree": 58.7441,
        "sign": "Taurus",
        "sign_id": 2,
        "house": 1
      },
      "planets": [
        {
          "name": "Sun",
          "sign": "Virgo",
          "sign_id": 6,
          "house": 5
        },
        {
          "name": "Moon",
          "sign": "Taurus",
          "sign_id": 2,
          "house": 1
        },
        {
          "name": "Mars",
          "sign": "Scorpio",
          "sign_id": 8,
          "house": 7
        },
        {
          "name": "Mercury",
          "sign": "Leo",
          "sign_id": 5,
          "house": 4
        },
        {
          "name": "Jupiter",
          "sign": "Capricorn",
          "sign_id": 10,
          "house": 9
        },
        {
          "name": "Venus",
          "sign": "Libra",
          "sign_id": 7,
          "house": 6
        },
        {
          "name": "Saturn",
          "sign": "Pisces",
          "sign_id": 12,
          "house": 11
        },
        {
          "name": "Rahu",
          "sign": "Leo",
          "sign_id": 5,
          "house": 4
        },
        {
          "name": "Ketu",
          "sign": "Aquarius",
          "sign_id": 11,
          "house": 10
        }
      ],
      "houses": [
        {
          "house": 1,
          "sign": "Taurus",
          "sign_id": 2,
          "degree_cusp": 0
        },
        {
          "house": 2,
          "sign": "Gemini",
          "sign_id": 3,
          "degree_cusp": 0
        },
        {
          "house": 3,
          "sign": "Cancer",
          "sign_id": 4,
          "degree_cusp": 0
        },
        {
          "house": 4,
          "sign": "Leo",
          "sign_id": 5,
          "degree_cusp": 0
        },
        {
          "house": 5,
          "sign": "Virgo",
          "sign_id": 6,
          "degree_cusp": 0
        },
        {
          "house": 6,
          "sign": "Libra",
          "sign_id": 7,
          "degree_cusp": 0
        },
        {
          "house": 7,
          "sign": "Scorpio",
          "sign_id": 8,
          "degree_cusp": 0
        },
        {
          "house": 8,
          "sign": "Sagittarius",
          "sign_id": 9,
          "degree_cusp": 0
        },
        {
          "house": 9,
          "sign": "Capricorn",
          "sign_id": 10,
          "degree_cusp": 0
        },
        {
          "house": 10,
          "sign": "Aquarius",
          "sign_id": 11,
          "degree_cusp": 0
        },
        {
          "house": 11,
          "sign": "Pisces",
          "sign_id": 12,
          "degree_cusp": 0
        },
        {
          "house": 12,
          "sign": "Aries",
          "sign_id": 1,
          "degree_cusp": 0
        }
      ],
      "row_sign_ids": {
        "Ascendant": 2,
        "Sun": 6,
        "Moon": 2,
        "Mars": 8,
        "Mercury": 5,
        "Jupiter": 10,
        "Venus": 7,
        "Saturn": 12,
        "Rahu": 5,
        "Ketu": 11
      }
    },
    "D4": {
      "division": 4,
      "name": "Chaturthamsha",
      "calibrated": true,
      "house_basis": "whole_sign_from_varga_ascendant",
      "ascendant": {
        "degree": null,
        "sign": "Aquarius",
        "sign_id": 11,
        "house": 1
      },
      "planets": [
        {
          "name": "Sun",
          "sign": "Virgo",
          "sign_id": 6,
          "house": 8
        },
        {
          "name": "Moon",
          "sign": "Aquarius",
          "sign_id": 11,
          "house": 1
        },
        {
          "name": "Mars",
          "sign": "Scorpio",
          "sign_id": 8,
          "house": 10
        },
        {
          "name": "Mercury",
          "sign": "Aquarius",
          "sign_id": 11,
          "house": 1
        },
        {
          "name": "Jupiter",
          "sign": "Cancer",
          "sign_id": 4,
          "house": 6
        },
        {
          "name": "Venus",
          "sign": "Aries",
          "sign_id": 1,
          "house": 3
        },
        {
          "name": "Saturn",
          "sign": "Sagittarius",
          "sign_id": 9,
          "house": 11
        },
        {
          "name": "Rahu",
          "sign": "Taurus",
          "sign_id": 2,
          "house": 4
        },
        {
          "name": "Ketu",
          "sign": "Scorpio",
          "sign_id": 8,
          "house": 10
        }
      ],
      "houses": [
        {
          "house": 1,
          "sign": "Aquarius",
          "sign_id": 11,
          "degree_cusp": null
        },
        {
          "house": 2,
          "sign": "Pisces",
          "sign_id": 12,
          "degree_cusp": null
        },
        {
          "house": 3,
          "sign": "Aries",
          "sign_id": 1,
          "degree_cusp": null
        },
        {
          "house": 4,
          "sign": "Taurus",
          "sign_id": 2,
          "degree_cusp": null
        },
        {
          "house": 5,
          "sign": "Gemini",
          "sign_id": 3,
          "degree_cusp": null
        },
        {
          "house": 6,
          "sign": "Cancer",
          "sign_id": 4,
          "degree_cusp": null
        },
        {
          "house": 7,
          "sign": "Leo",
          "sign_id": 5,
          "degree_cusp": null
        },
        {
          "house": 8,
          "sign": "Virgo",
          "sign_id": 6,
          "degree_cusp": null
        },
        {
          "house": 9,
          "sign": "Libra",
          "sign_id": 7,
          "degree_cusp": null
        },
        {
          "house": 10,
          "sign": "Scorpio",
          "sign_id": 8,
          "degree_cusp": null
        },
        {
          "house": 11,
          "sign": "Sagittarius",
          "sign_id": 9,
          "degree_cusp": null
        },
        {
          "house": 12,
          "sign": "Capricorn",
          "sign_id": 10,
          "degree_cusp": null
        }
      ],
      "row_sign_ids": {
        "Ascendant": 11,
        "Sun": 6,
        "Moon": 11,
        "Mars": 8,
        "Mercury": 11,
        "Jupiter": 4,
        "Venus": 1,
        "Saturn": 9,
        "Rahu": 2,
        "Ketu": 8
      }
    },
    "D9": {
      "division": 9,
      "name": "Navamsha",
      "calibrated": true,
      "house_basis": "whole_sign_from_varga_ascendant",
      "ascendant": {
        "degree": null,
        "sign": "Virgo",
        "sign_id": 6,
        "house": 1
      },
      "planets": [
        {
          "name": "Sun",
          "sign": "Aquarius",
          "sign_id": 11,
          "house": 6
        },
        {
          "name": "Moon",
          "sign": "Leo",
          "sign_id": 5,
          "house": 12
        },
        {
          "name": "Mars",
          "sign": "Cancer",
          "sign_id": 4,
          "house": 11
        },
        {
          "name": "Mercury",
          "sign": "Virgo",
          "sign_id": 6,
          "house": 1
        },
        {
          "name": "Jupiter",
          "sign": "Gemini",
          "sign_id": 3,
          "house": 10
        },
        {
          "name": "Venus",
          "sign": "Pisces",
          "sign_id": 12,
          "house": 7
        },
        {
          "name": "Saturn",
          "sign": "Aquarius",
          "sign_id": 11,
          "house": 6
        },
        {
          "name": "Rahu",
          "sign": "Scorpio",
          "sign_id": 8,
          "house": 3
        },
        {
          "name": "Ketu",
          "sign": "Taurus",
          "sign_id": 2,
          "house": 9
        }
      ],
      "houses": [
        {
          "house": 1,
          "sign": "Virgo",
          "sign_id": 6,
          "degree_cusp": null
        },
        {
          "house": 2,
          "sign": "Libra",
          "sign_id": 7,
          "degree_cusp": null
        },
        {
          "house": 3,
          "sign": "Scorpio",
          "sign_id": 8,
          "degree_cusp": null
        },
        {
          "house": 4,
          "sign": "Sagittarius",
          "sign_id": 9,
          "degree_cusp": null
        },
        {
          "house": 5,
          "sign": "Capricorn",
          "sign_id": 10,
          "degree_cusp": null
        },
        {
          "house": 6,
          "sign": "Aquarius",
          "sign_id": 11,
          "degree_cusp": null
        },
        {
          "house": 7,
          "sign": "Pisces",
          "sign_id": 12,
          "degree_cusp": null
        },
        {
          "house": 8,
          "sign": "Aries",
          "sign_id": 1,
          "degree_cusp": null
        },
        {
          "house": 9,
          "sign": "Taurus",
          "sign_id": 2,
          "degree_cusp": null
        },
        {
          "house": 10,
          "sign": "Gemini",
          "sign_id": 3,
          "degree_cusp": null
        },
        {
          "house": 11,
          "sign": "Cancer",
          "sign_id": 4,
          "degree_cusp": null
        },
        {
          "house": 12,
          "sign": "Leo",
          "sign_id": 5,
          "degree_cusp": null
        }
      ],
      "row_sign_ids": {
        "Ascendant": 6,
        "Sun": 11,
        "Moon": 5,
        "Mars": 4,
        "Mercury": 6,
        "Jupiter": 3,
        "Venus": 12,
        "Saturn": 11,
        "Rahu": 8,
        "Ketu": 2
      }
    }
  },
  "metadata": {
    "endpoint_version": "v2",
    "ruleset_version": "classical_varga_v1",
    "ayanamsha": "lahiri",
    "house_system": "whole_sign",
    "node_type": "mean",
    "timezone_used": "Asia/Kolkata",
    "requested_divisions": [
      1,
      4,
      9
    ],
    "supported_divisions": [
      1,
      2,
      3,
      4,
      5,
      7,
      9,
      10,
      12,
      16,
      20,
      24,
      27,
      30,
      40,
      45,
      60
    ],
    "calibrated_divisions": [
      1,
      2,
      3,
      4,
      7,
      9,
      10,
      12,
      16,
      20,
      24,
      27,
      30,
      40,
      45,
      60
    ]
  }
}

Related Docs

Basic Vedic chartVisual charts (SVG/PNG)Planetary strength