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. KP takes ruling planets at the moment of judgment, so with no target_date and no target_time the current instant is used. target_time alone means that time today; target_date alone means 12:00 on that date. Local date and time are read in target_timezone, which defaults to the time zone at the coordinates. target_utc and target_timezone in the response show the instant and zone used. A date not in the calendar (e.g. 2026-02-30) is rejected with 422 saying it does not exist; dates outside 1800-01-01 to 2099-12-31 are rejected with 422 too. A local time skipped by a daylight-saving change is read with the offset before the change (moved forward by the gap), a repeated time as its first occurrence; local_time_status says which applied. Works at every latitude, including inside the polar circles: only the ascendant is used, which needs no house cusps (the day lord still needs a sunrise). 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, local date in target_timezone. Omit together with target_time to use the current instant. Given without target_time, 12:00 local on that date is used. A date that is not in the calendar (e.g. 2026-02-30) is rejected with 422 saying the date does not exist. Supported dates: 1800-01-01 to 2099-12-31.

target_timeoptional

string | null

HH:MM (24-hour), local time in target_timezone. Given without target_date, that time today is used. Omit together with target_date to use the current instant. A time skipped by a daylight-saving change (e.g. 02:30 on 2026-03-08 in America/New_York) is read with the offset in force before the change, i.e. moved forward by the gap (03:30 EDT); a time that occurred twice is read as the first occurrence. local_time_status in the response says which applied.

target_timezoneoptional

string | null

IANA timezone (or explicit UTC offset) for target_date and target_time. Defaults to the time zone at the coordinates.

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.ayanamsa

string

data.target_utc

string

The instant used, ISO 8601 UTC.

data.target_timezone

string

Time zone used to read target_date/target_time and for the sunrise-based day lord.

data.local_time_status

string

How target_date/target_time was read. 'nonexistent': the local time fell in a daylight-saving gap and was read with the offset in force before the change (moved forward by the gap). 'ambiguous': the local time occurred twice and the first occurrence was used. 'ok' otherwise, including when the current instant was used.

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

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

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 '{"latitude":19.076,"longitude":72.8777,"target_date":"1985-11-12","target_time":"06:45","target_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(
    latitude=19.076,
    longitude=72.8777,
    target_date="1985-11-12",
    target_time="06:45",
    target_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: {
      "latitude": 19.076,
      "longitude": 72.8777,
      "target_date": "1985-11-12",
      "target_time": "06:45",
      "target_timezone": "Asia/Kolkata"
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "ayanamsa": "kp",
    "target_utc": "1985-11-12T01:15:00Z",
    "target_timezone": "Asia/Kolkata",
    "day_lord": "Mars",
    "moon": {
      "longitude": 198.279,
      "rashi": "Tula",
      "sign_lord": "Venus",
      "nakshatra_lord": "Rahu",
      "sub_lord": "Moon"
    },
    "ascendant": {
      "longitude": 205.3997,
      "rashi": "Tula",
      "sign_lord": "Venus",
      "nakshatra_lord": "Jupiter",
      "sub_lord": "Mercury"
    },
    "ruling_planets": [
      "Jupiter",
      "Venus",
      "... and 2 more items"
    ],
    "local_time_status": "ok"
  }
}