KP horary (praśna) chart, numbers 1–249

POST/v1/kp/horary

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

A horary chart from the querent's number. 3 units.

The number fixes the ascendant at the commencement of its division in the 249-fold lattice — the 243 sub-divisions together with the six sign cusps that fall inside a sub and split it. The remaining eleven cusps are the Placidus cusps for that ascendant; the moment you supply governs the planets and the ruling planets, not the house framework.

Verified against Krishnamurti's own published values in KP Reader 3: number 37 gives Taurus 22°40′ and number 206 gives Capricorn 26°6′40″, both exact.

Body parameters#

horary_numberintegerRequired

The querent's number.

min 1 · max 249.

momentstring · date-timeRequired

The moment of judgment, ISO 8601 with offset.

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.

questionstringoptional

Optional. Used only to select the house of the matter.

Request#

POST /v1/kp/horary

curl -X POST https://api.grahvani.in/v1/kp/horary \
  -H "X-API-Key: $GRAHVANI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "horary_number": 37,
  "moment": "2026-08-06T09:12:03+05:30",
  "place": {
    "latitude": 27.1767,
    "longitude": 78.0081,
    "timezone": "Asia/Kolkata"
  },
  "question": "Will the contract be signed?"
}'

import os, requests

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

payload = {
    "horary_number": 37,
    "moment": "2026-08-06T09:12:03+05:30",
    "place": {
        "latitude": 27.1767,
        "longitude": 78.0081,
        "timezone": "Asia/Kolkata"
    },
    "question": "Will the contract be signed?"
}

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/kp/horary", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.GRAHVANI_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "horary_number": 37,
    "moment": "2026-08-06T09:12:03+05:30",
    "place": {
      "latitude": 27.1767,
      "longitude": 78.0081,
      "timezone": "Asia/Kolkata"
    },
    "question": "Will the contract be signed?"
  }),
});

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/kp/horary");
$headers = ["X-API-Key: " . getenv("GRAHVANI_KEY")];
$headers[] = "Content-Type: application/json";
$payload = [
    "horary_number" => 37,
    "moment" => "2026-08-06T09:12:03+05:30",
    "place" => [
        "latitude" => 27.1767,
        "longitude" => 78.0081,
        "timezone" => "Asia/Kolkata"
    ],
    "question" => "Will the contract be signed?"
];
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": {
      "deg_in_sign": 22.666667,
      "longitude": 52.666667,
      "nakshatra_lord": "Moon",
      "rasi_lord": "Venus",
      "sign": "Taurus",
      "sub_lord": "Sun",
      "sub_sub_lord": "Sun",
      "sub_sub_sub_lord": "Sun"
    },
    "chart_radicality": {
      "early_ascendant": false,
      "late_ascendant": false
    },
    "date": "2026-08-06",
    "final_judgment": {
      "confidence": "MEDIUM",
      "rationale": "Sub-lord chain verdict: Chain lords strongly favor good houses: [('Jupiter', [10, 11]), ('Saturn', [10, 11])]. Event window: Event possible during Dasha of Venus ((2020, 11, 29)–(2040, 11, 29)).",
      "timing_estimate": {
        "dasha_layer": "Dasha",
        "end_date": [
          2040,
          11,
          29
        ],
        "event_estimate": "Event possible during Dasha of Venus ((2020, 11, 29)–(2040, 11, 29))",
        "good_houses": [
          6
        ],
        "lord": "Venus",
        "start_date": [
          2020,
          11,
          29
        ]
      },
      "yes_no": "YES (with dasha support)"
    },
    "horary_number": 37,
    "house_cusps": [
      {
        "deg_in_sign": 22.666667,
        "house": 1,
        "longitude": 52.666667,
        "nakshatra_lord": "Moon",
        "rasi_lord": "Venus",
        "sign": "Taurus",
        "sub_lord": "Sun",
        "sub_sub_lord": "Sun",
        "sub_sub_sub_lord": "Sun"
      },
      {
        "deg_in_sign": 16.534703,
        "house": 2,
        "longitude": 76.534703,
        "nakshatra_lord": "Rahu",
        "rasi_lord": "Mercury",
        "sign": "Gemini",
        "sub_lord": "Venus",
        "sub_sub_lord": "Jupiter",
        "sub_sub_sub_lord": "Venus"
      },
      {
        "deg_in_sign": 10.172002,
        "house": 3,
        "longitude": 100.172002,
        "nakshatra_lord": "Saturn",
        "rasi_lord": "Moon",
        "sign": "Cancer",
        "sub_lord": "Venus",
        "sub_sub_lord": "Mercury",
        "sub_sub_sub_lord": "Saturn"
      },
      "… 9 more (truncated for the docs)"
    ],
    "kp_timing": [
      {
        "dasha_layer": "Dasha",
        "end_date": [
          2040,
          11,
          29
        ],
        "event_estimate": "Event possible during Dasha of Venus ((2020, 11, 29)–(2040, 11, 29))",
        "good_houses": [
          6
        ],
        "lord": "Venus",
        "start_date": [
          2020,
          11,
          29
        ]
      },
      {
        "dasha_layer": "Bhukti",
        "end_date": [
          2026,
          11,
          29
        ],
        "event_estimate": "Event possible during Bhukti of Moon ((2025, 3, 30)–(2026, 11, 29))",
        "good_houses": [
          6
        ],
        "lord": "Moon",
        "start_date": [
          2025,
          3,
          30
        ]
      },
      {
        "dasha_layer": "Antara",
        "end_date": [
          2026,
          10,
          25
        ],
        "event_estimate": "Event possible during Antara of Mercury ((2026, 7, 30)–(2026, 10, 25))",
        "good_houses": [
          11
        ],
        "lord": "Mercury",
        "start_date": [
          2026,
          7,
          30
        ]
      },
      "… 1 more (truncated for the docs)"
    ],
    "lagna_planets": [
      {
        "deg_in_sign": 2.247395,
        "house_occupied": 1,
        "longitude": 62.247395,
        "nakshatra_lord": "Mars",
        "name": "Mars",
        "rasi_lord": "Mercury",
        "retrograde": false,
        "sign": "Gemini",
        "sub_lord": "Ketu",
        "sub_sub_lord": "Rahu",
        "sub_sub_sub_lord": "Saturn"
      }
    ],
    "latitude": 27.1767,
    "longitude": 78.0081,
    "main_house": 10,
    "moon_void_of_course": {
      "degrees_left": 12.877690999999999,
      "void_of_course": false
    },
    "planets": [
      {
        "deg_in_sign": 19.368123,
        "house_occupied": 3,
        "longitude": 109.368123,
        "nakshatra_lord": "Mercury",
        "name": "Sun",
        "rasi_lord": "Moon",
        "retrograde": false,
        "sign": "Cancer",
        "sub_lord": "Venus",
        "sub_sub_lord": "Venus",
        "sub_sub_sub_lord": "Venus"
      },
      {
        "deg_in_sign": 17.122309,
        "house_occupied": 12,
        "longitude": 17.122309,
        "nakshatra_lord": "Venus",
        "name": "Moon",
        "rasi_lord": "Mars",
        "retrograde": false,
        "sign": "Aries",
        "sub_lord": "Moon",
        "sub_sub_lord": "Venus",
        "sub_sub_sub_lord": "Venus"
      },
      {
        "deg_in_sign": 2.247395,
        "house_occupied": 1,
        "longitude": 62.247395,
        "nakshatra_lord": "Mars",
        "name": "Mars",
        "rasi_lord": "Mercury",
        "retrograde": false,
        "sign": "Gemini",
        "sub_lord": "Ketu",
        "sub_sub_lord": "Rahu",
        "sub_sub_sub_lord": "Saturn"
      },
      "… 6 more (truncated for the docs)"
    ],
    "planets_in_houses": [
      [
        {
          "deg_in_sign": 2.247395,
          "house_occupied": 1,
          "longitude": 62.247395,
          "nakshatra_lord": "Mars",
          "name": "Mars",
          "rasi_lord": "Mercury",
          "retrograde": false,
          "sign": "Gemini",
          "sub_lord": "Ketu",
          "sub_sub_lord": "Rahu",
          "sub_sub_sub_lord": "Saturn"
        }
      ],
      [
        {
          "deg_in_sign": 0.503938,
          "house_occupied": 2,
          "longitude": 90.503938,
          "nakshatra_lord": "Jupiter",
          "name": "Mercury",
          "rasi_lord": "Moon",
          "retrograde": false,
          "sign": "Cancer",
          "sub_lord": "Moon",
          "sub_sub_lord": "Sun",
          "sub_sub_sub_lord": "Moon"
        }
      ],
      [
        {
          "deg_in_sign": 19.368123,
          "house_occupied": 3,
          "longitude": 109.368123,
          "nakshatra_lord": "Mercury",
          "name": "Sun",
          "rasi_lord": "Moon",
          "retrograde": false,
          "sign": "Cancer",
          "sub_lord": "Venus",
          "sub_sub_lord": "Venus",
          "sub_sub_sub_lord": "Venus"
        },
        {
          "deg_in_sign": 13.916593,
          "house_occupied": 3,
          "longitude": 103.916593,
          "nakshatra_lord": "Saturn",
          "name": "Jupiter",
          "rasi_lord": "Moon",
          "retrograde": false,
          "sign": "Cancer",
          "sub_lord": "Rahu",
          "sub_sub_lord": "Mercury",
          "sub_sub_sub_lord": "Mars"
        },
        {
          "deg_in_sign": 5.770345,
          "house_occupied": 3,
          "longitude": 125.770345,
          "nakshatra_lord": "Ketu",
          "name": "Ketu",
          "rasi_lord": "Sun",
          "retrograde": false,
          "sign": "Leo",
          "sub_lord": "Rahu",
          "sub_sub_lord": "Rahu",
          "sub_sub_sub_lord": "Venus"
        }
      ],
      "… 9 more (truncated for the docs)"
    ],
    "question": "Will the contract be signed?",
    "ruling_planets": {
      "asc_sign_lord": "Venus",
      "asc_star_lord": "Moon",
      "day_lord": "Jupiter",
      "moon_sign_lord": "Mars",
      "moon_star_lord": "Venus"
    },
    "significators": {
      "lords": [
        "Saturn"
      ],
      "main_house": 10,
      "occupants": [],
      "planets_signifying": [
        {
          "house_occupied": 3,
          "houses_signified": [
            2,
            3,
            4,
            "… 1 more (truncated for the docs)"
          ],
          "links": [
            "occupant of 3",
            "star-lord for lord of 2",
            "lord of 4",
            "… 1 more (truncated for the docs)"
          ],
          "nakshatra_lord": "Mercury",
          "planet": "Sun",
          "rasi_lord": "Moon",
          "sub_lord": "Venus"
        },
        {
          "house_occupied": 12,
          "houses_signified": [
            1,
            3,
            6,
            "… 1 more (truncated for the docs)"
          ],
          "links": [
            "occupant of 12",
            "star-lord for lord of 1",
            "lord of 3",
            "… 1 more (truncated for the docs)"
          ],
          "nakshatra_lord": "Venus",
          "planet": "Moon",
          "rasi_lord": "Mars",
          "sub_lord": "Moon"
        },
        {
          "house_occupied": 1,
          "houses_signified": [
            1,
            7,
            12
          ],
          "links": [
            "occupant of 1",
            "lord of 7",
            "star-lord for lord of 7",
            "… 2 more (truncated for the docs)"
          ],
          "nakshatra_lord": "Mars",
          "planet": "Mars",
          "rasi_lord": "Mercury",
          "sub_lord": "Ketu"
        },
        "… 6 more (truncated for the docs)"
      ],
      "star_lords": [
        "Jupiter"
      ]
    },
    "sub_lord_chain_judgment": {
      "chain": [
        {
          "bad": [
            12
          ],
          "good": [],
          "houses_signified": [
            7,
            9,
            12
          ],
          "neutral": [
            7,
            9
          ],
          "planet": "Rahu"
        },
        {
          "bad": [
            8
          ],
          "good": [
            10,
            11
          ],
          "houses_signified": [
            3,
            8,
            9,
            "… 2 more (truncated for the docs)"
          ],
          "neutral": [
            3,
            9
          ],
          "planet": "Jupiter"
        },
        {
          "bad": [
            5
          ],
          "good": [
            10,
            11
          ],
          "houses_signified": [
            2,
            5,
            9,
            "… 2 more (truncated for the docs)"
          ],
          "neutral": [
            2,
            9
          ],
          "planet": "Saturn"
        }
      ],
      "confidence": "MEDIUM",
      "rationale": "Chain lords strongly favor good houses: [('Jupiter', [10, 11]), ('Saturn', [10, 11])]",
      "verdict": "YES"
    },
    "time": "03:42:03",
    "tz_offset": 5.5,
    "vimshottari_dasha": [
      {
        "end_date": [
          2040,
          11,
          29
        ],
        "end_jd": 2466487.539991347,
        "level": "Dasha",
        "lord": "Venus",
        "start_date": [
          2020,
          11,
          29
        ],
        "start_jd": 2459182.539991347
      },
      {
        "end_date": [
          2026,
          11,
          29
        ],
        "end_jd": 2461374.039991347,
        "level": "Bhukti",
        "lord": "Moon",
        "percent_elapsed": 81.01,
        "start_date": [
          2025,
          3,
          30
        ],
        "start_jd": 2460765.289991347
      },
      {
        "end_date": [
          2026,
          10,
          25
        ],
        "end_jd": 2461338.52957468,
        "level": "Antara",
        "lord": "Mercury",
        "percent_elapsed": 7.11,
        "start_date": [
          2026,
          7,
          30
        ],
        "start_jd": 2461252.2899913467
      },
      "… 1 more (truncated for the docs)"
    ]
  },
  "meta": {
    "request_id": "req_01JQ8ZK3M4N5P6Q7R8S9T",
    "endpoint": "kp.horary",
    "units": 3,
    "computed_at": "2026-08-06T07:23:41.571Z",
    "ayanamsa": "kp"
  },
  "provenance": {
    "method": "KP horary: ascendant at the commencement of the division in the 249-fold lattice",
    "conventions": {
      "lattice": "243 sub-divisions ∪ the 6 sign cusps that split a sub = 249",
      "sub_lord_boundary": "half-open [start, end) — the sub that BEGINS owns the boundary",
      "cusps": "Placidus, from the ARMC whose ascendant IS the horary ascendant",
      "ayanamsa": "KP New (Krishnamurti)"
    },
    "sources": [
      {
        "work": "K. S. Krishnamurti, KP Reader 3",
        "locus": "horary numbers 37 and 206"
      }
    ],
    "verified_against": "KSK's published values: #37 = Taurus 22°40′, #206 = Capricorn 26°6′40″"
  }
}

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`.

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