Kp Ruling Planets

POST/v1/rectification/kp-ruling-planets

KP ruling planet method: At the query moment, 6 ruling planets are identified. The birth time is valid when the Lagna sub lord at birth matches one of these. Returns ruling planets + sub lord for every 4-minute window in the search range.

Example request

cURL
curl -X POST https://api.grahaapi.com/v1/rectification/kp-ruling-planets \
  -H "Authorization: Bearer sk-test-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "approx_tob": "22:00",
    "dob": "1990-06-15",
    "lat": 28.6139,
    "lon": 77.209,
    "tz": 5.5
  }'

Test keys (sk-test-…) are free and unlimited, and return the exact production response structure computed from a fixed sample chart. The response is JSON: {"success": true, "data": {…}, "meta": {…}} with Hindi name twins where available (e.g. sign / sign_hi), computed on the Lahiri ayanamsa.

Request fields

FieldTypeRequiredDescription
dobstringrequiredDate of birth YYYY-MM-DD
approx_tobstringrequiredApproximate birth time HH:MM to check
latnumberrequiredLatitude
lonnumberrequiredLongitude
tznumberoptionalUTC offset (IST = 5.5)
query_datetimestring | nulloptionalYYYY-MM-DD HH:MM — time of query (defaults to now)

Example body

JSON
{
  "approx_tob": "22:00",
  "dob": "1990-06-15",
  "lat": 28.6139,
  "lon": 77.209,
  "tz": 5.5
}