POST/v1/astro/kp/ruling-planets

KP Ruling Planets

Computes KP Ruling Planets at a given moment (no natal birth chart). Request body: latitude, longitude, optional target_date, target_time, target_timezone. Returns day lord, Moon sign/nakshatra/sub lords, ascendant sign/nakshatra/sub lords, and the combined list of ruling planets in priority order.

Request parameters

latituderequired

number

Location latitude in decimal degrees. North positive, south negative.

longituderequired

number

Location longitude in decimal degrees. East positive, west negative.

target_dateoptional

string | null

YYYY-MM-DD. Defaults to today.

target_timeoptional

string | null

HH:MM

target_timezoneoptional

string | null

IANA timezone

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.ayanamsa

string

data.target_utc

string

data.day_lord

string

data.moon

object

data.moon.longitude

number

data.moon.rashi

string

data.moon.sign_lord

string

data.moon.nakshatra_lord

string

data.moon.sub_lord

string

data.ascendant

object

data.ascendant.longitude

number

data.ascendant.rashi

string

data.ascendant.sign_lord

string

data.ascendant.nakshatra_lord

string

data.ascendant.sub_lord

string

data.ruling_planets

array[string]

Errors

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

Reserved; product endpoints are not feature-gated by plan (quota differs by tier).

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

• KP Natal Chart
• KP House Significators

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/astro/kp/ruling-planets" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1985-11-12","time":"06:45","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata"}'

Python

import asterwise
from asterwise.api.kp_api import KpApi
from asterwise.models.kp_ruling_planets_request import KPRulingPlanetsRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = KPRulingPlanetsRequest(
    date="1985-11-12",
    time="06:45",
    latitude=19.076,
    longitude=72.8777,
    timezone="Asia/Kolkata",
)

with asterwise.ApiClient(configuration) as client:
    api = KpApi(client)
    result = api.kp_ruling_planets(kp_ruling_planets_request=request)
    print(result)

TypeScript

import { createClient, createConfig, kpRulingPlanets } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await kpRulingPlanets({
  client,
  body: {
      "date": "1985-11-12",
      "time": "06:45",
      "latitude": 19.076,
      "longitude": 72.8777,
      "timezone": "Asia/Kolkata"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "ayanamsa": "kp",
    "target_utc": "2026-05-28T06:30:00Z",
    "day_lord": "Jupiter",
    "moon": {
      "longitude": 188.7129,
      "rashi": "Tula",
      "sign_lord": "Venus",
      "nakshatra_lord": "Rahu",
      "sub_lord": "Jupiter"
    },
    "ascendant": {
      "longitude": 124.1453,
      "rashi": "Simha",
      "sign_lord": "Sun",
      "nakshatra_lord": "Ketu",
      "sub_lord": "Moon"
    },
    "ruling_planets": [
      "Ketu",
      "Sun",
      "... and 3 more items"
    ]
  }
}