Which operations exist in which ayanāṁśa school

GET/v1/meta/capabilities

Cost: Free
Operation: metaCapabilities
Auth: X-API-Key

Free — 0 units. Read this before building against a non-default school.

The schools are not equal in depth, and the gap is large enough that assuming otherwise will break an integration. Measured on 2026-08-04:

School	Operations	Share of Lahiri
lahiri (default)	668	—
yukteswar	48	7.2%
bhasin	47	7.0%
raman	35	5.2%
kp	17	2.5%
true_chitra	12	1.8%

Lahiri carries the yogas, doṣas, Jaimini, Nāḍī, balas and remedies. The other schools carry charts and daśās. Requesting an operation a school does not implement returns 501 naming the schools that do — never a 404, and never a silent fallback to Lahiri.

Request#

GET /v1/meta/capabilities

curl -X GET https://api.grahvani.in/v1/meta/capabilities \
  -H "X-API-Key: $GRAHVANI_KEY"

import os, requests

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

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

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

const res = await fetch("https://api.grahvani.in/v1/meta/capabilities", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.GRAHVANI_KEY,
  },
});

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/meta/capabilities");
$headers = ["X-API-Key: " . getenv("GRAHVANI_KEY")];
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": {
    "default_ayanamsa": "lahiri",
    "note": "Lahiri is by far the deepest school. Requesting an operation a school does not implement returns 501 naming the schools that do — never a 404, and never a silent fallback.",
    "operations": [
      {
        "operation": "charts.divisional.d10",
        "units": 3,
        "schools": [
          "bhasin",
          "lahiri",
          "raman",
          "… 1 more (truncated for the docs)"
        ]
      },
      {
        "operation": "charts.divisional.d12",
        "units": 3,
        "schools": [
          "bhasin",
          "lahiri",
          "raman",
          "… 1 more (truncated for the docs)"
        ]
      },
      {
        "operation": "charts.divisional.d16",
        "units": 3,
        "schools": [
          "bhasin",
          "lahiri",
          "raman",
          "… 1 more (truncated for the docs)"
        ]
      },
      "… 14 more (truncated for the docs)"
    ]
  },
  "meta": {
    "request_id": "req_01JQ8ZK3M4N5P6Q7R8S9T",
    "endpoint": "meta.capabilities",
    "units": 0,
    "computed_at": "2026-08-06T07:23:59.608Z"
  }
}

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