Charts

Divisional (varga) chart

POST/v1/charts/divisional/{varga}

Cost: 3 units
Operation: chartsDivisional
Auth: X-API-Key

A divisional chart — D2 through D60. 3 units.

This is one of the 41 operations that genuinely exist in more than one ayanāṁśa school, so ayanamsa is honoured here. Most of this API is Lahiri-only; check GET /v1/meta/capabilities rather than assuming.

Path parameters#

vargaenum · pathRequired

The division. d9 is the navāṁśa. One of d2, d3, d4, d7, d9, d10, d12, d16, d20, d24, d27, d30, d40, d45, d60.

Body parameters#

birthobjectRequired

datestring · dateRequired

timestringoptional

Local clock time at the place of birth. If unknown, omit it — we use 12:00 noon and set meta.birth_time_assumed, and still return the full chart. We do not refuse a reading for want of a birth time.

placeobjectRequired

latitudenumberRequired

min -90 · max 90.

longitudenumberRequired

min -180 · max 180.

timezonestringRequired

IANA name, e.g. Asia/Kolkata. Not a fixed offset — an offset cannot represent historical daylight-saving transitions, and a birth in 1980 may need one.

ayanamsaenumoptional

Honoured only where the operation exists in that school — 41 of them do. Everything else is Lahiri-only and returns 501 for another school. See GET /v1/meta/capabilities.

One of lahiri, raman, yukteswar, bhasin, true_chitra, kp. Defaults to "lahiri".

Request#

POST /v1/charts/divisional/{varga}

curl -X POST https://api.grahvani.in/v1/charts/divisional/{varga} \
  -H "X-API-Key: $GRAHVANI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "birth": {
    "date": "1980-05-01",
    "time": "05:16:00",
    "place": {
      "latitude": 27.1767,
      "longitude": 78.0081,
      "timezone": "Asia/Kolkata"
    }
  }
}'

import os, requests

URL = "https://api.grahvani.in/v1/charts/divisional/{varga}"
HEADERS = {"X-API-Key": os.environ["GRAHVANI_KEY"]}

payload = {
    "birth": {
        "date": "1980-05-01",
        "time": "05:16:00",
        "place": {
            "latitude": 27.1767,
            "longitude": 78.0081,
            "timezone": "Asia/Kolkata"
        }
    }
}

r = requests.post(URL, headers=HEADERS, json=payload, timeout=60)
r.raise_for_status()
data = r.json()

print(data["meta"]["units"], "units")

const res = await fetch("https://api.grahvani.in/v1/charts/divisional/{varga}", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.GRAHVANI_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "birth": {
      "date": "1980-05-01",
      "time": "05:16:00",
      "place": {
        "latitude": 27.1767,
        "longitude": 78.0081,
        "timezone": "Asia/Kolkata"
      }
    }
  }),
});

if (!res.ok) throw new Error((await res.json()).error.message);
const { data, meta } = await res.json();
console.log(meta.units, "units");

<?php
$ch = curl_init("https://api.grahvani.in/v1/charts/divisional/{varga}");
$headers = ["X-API-Key: " . getenv("GRAHVANI_KEY")];
$headers[] = "Content-Type: application/json";
$payload = [
    "birth" => [
        "date" => "1980-05-01",
        "time" => "05:16:00",
        "place" => [
            "latitude" => 27.1767,
            "longitude" => 78.0081,
            "timezone" => "Asia/Kolkata"
        ]
    ]
];
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true);
echo $data["meta"]["units"] . " units";

Response#

A real response from the production API, abbreviated where an array was long. Every success carries the same three keys — data, meta and, where we have something citable, provenance.

200 OK

{
  "data": {
    "ascendant": {
      "degrees": "16° 59' 20.77\"",
      "nakshatra": "Ardra",
      "pada": 4,
      "sign": "Gemini"
    },
    "notes": {
      "ayanamsa": "Lahiri",
      "ayanamsa_value": "23.582335",
      "chart_type": "Navamsa (D9)",
      "house_system": "Whole Sign"
    },
    "planetary_positions": {
      "Jupiter": {
        "degrees": "0° 15' 7.97\"",
        "house": 1,
        "nakshatra": "Mrigashira",
        "pada": 3,
        "retrograde": "",
        "sign": "Gemini"
      },
      "Ketu": {
        "degrees": "23° 25' 26.61\"",
        "house": 5,
        "nakshatra": "Vishakha",
        "pada": 2,
        "retrograde": "",
        "sign": "Libra"
      },
      "Mars": {
        "degrees": "20° 26' 6.70\"",
        "house": 12,
        "nakshatra": "Rohini",
        "pada": 4,
        "retrograde": "",
        "sign": "Taurus"
      },
      "Mercury": {
        "degrees": "2° 27' 14.68\"",
        "house": 12,
        "nakshatra": "Krittika",
        "pada": 2,
        "retrograde": "",
        "sign": "Taurus"
      },
      "Moon": {
        "degrees": "12° 59' 31.93\"",
        "house": 12,
        "nakshatra": "Rohini",
        "pada": 1,
        "retrograde": "",
        "sign": "Taurus"
      },
      "Rahu": {
        "degrees": "23° 25' 26.61\"",
        "house": 11,
        "nakshatra": "Bharani",
        "pada": 4,
        "retrograde": "R",
        "sign": "Aries"
      },
      "Saturn": {
        "degrees": "3° 3' 55.78\"",
        "house": 7,
        "nakshatra": "Mula",
        "pada": 1,
        "retrograde": "R",
        "sign": "Sagittarius"
      },
      "Sun": {
        "degrees": "4° 38' 5.12\"",
        "house": 4,
        "nakshatra": "Uttara Phalguni",
        "pada": 3,
        "retrograde": "",
        "sign": "Virgo"
      },
      "Venus": {
        "degrees": "28° 34' 17.55\"",
        "house": 4,
        "nakshatra": "Chitra",
        "pada": 2,
        "retrograde": "",
        "sign": "Virgo"
      }
    }
  },
  "meta": {
    "request_id": "req_01JQ8ZK3M4N5P6Q7R8S9T",
    "endpoint": "charts.divisional",
    "units": 3,
    "computed_at": "2026-08-06T07:23:23.518Z",
    "ayanamsa": "lahiri"
  }
}

Errors#

Status	When
`400`	Your request. Always carries `error.field` when a single input is at fault.
`401`	Missing, malformed, revoked or out-of-scope API key.
`429`	Rate limit or monthly unit quota exhausted. Always carries `Retry-After`.
`501`	The operation exists, but not in the ayanāṁśa school you asked for. The body names the

Every failure returns the same error shape and a doc_url that resolves. See Errors and the full code list.

Introduction API reference Errors OpenAPI spec llms.txt

Grahvani API — a product of AstroCorp Techlab Pvt Ltd · GSTIN 36AAMCC3512G1ZU

Base URL https://api.grahvani.in