POST/v1/astro/kp/significators

KP House Significators

Computes KP house significators for all 12 houses. For each house returns: occupants (cusp-to-cusp), the sign lord of the cusp, planets in the nakshatra of an occupant, and planets in the nakshatra of the sign lord. Krishnamurti ranks them strongest first as: planets in the star of occupants, occupants, planets in the star of the sign lord, the sign lord; strength_order lists them in that order. all_significators keeps its original order (occupants, sign lord, star of occupants, star of sign lord) and is not a ranking. Planet house is the KP (cusp-to-cusp) house: a planet is in house h from cusp h up to, not including, cusp h+1 of the sidereal Placidus cusps, and a planet exactly on a cusp is in the house that cusp starts (no orb before a cusp). rasi_house is the whole-sign house from the lagna sign. Inside the polar circles, where Placidus cusps do not exist, the request fails with 422 validation_error instead of returning another house system; its details item has type and issue no_quadrant_houses_at_this_latitude and input_format_ok: true (the input is valid; the sky has no Placidus cusps there). Request JSON follows BirthInput: name, date (YYYY-MM-DD), time (HH:MM, required), either location or latitude/longitude/timezone. ayanamsa is accepted but ignored: KP always uses the Krishnamurti ayanamsa.

Request parameters

locationoptional

string | null

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

nameoptional

string

Person name associated with the birth record

daterequired

string

Birth date in YYYY-MM-DD format

timerequired

string

Birth time in HH:MM 24-hour format. Required: this endpoint has no sunrise fallback.

latitudeoptional

number | null

Latitude. Required if location not provided.

longitudeoptional

number | null

Longitude. Required if location not provided.

timezoneoptional

string | null

IANA timezone. Required if location not provided (unless utc_offset is given). For dates before the zone adopted a standard time, the birthplace's local mean time (longitude / 15 hours) is used.

utc_offsetoptional

string | null

Optional explicit UTC offset of the birth time, as ±HH:MM or ±HH:MM:SS (e.g. '+04:51:31' for Bombay mean time). Overrides the offset timezone would give. Use it when the birth record states the offset, or for historical local times the IANA database cannot represent.

ayanamsaoptional

string

Ignored: KP always uses the Krishnamurti (KP) ayanamsa. Accepted so requests that send it keep working.

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.birth_time_provided

boolean

True when a birth time was supplied. False when it was not: house, Ascendant and Moon-dependent results then carry the accuracy limits of an unknown birth time.

data.ayanamsa

string

data.significators

object

data.planet_significators

object

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 Ruling Planets

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/astro/kp/significators" \
  -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_birth_request import KPBirthRequest

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

request = KPBirthRequest(
    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_significators(kp_birth_request=request)
    print(result)

TypeScript

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

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

const result = await kpSignificators({
  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",
    "significators": {
      "1": {
        "house": 1,
        "sign_lord": "Venus",
        "occupants": [
          "Sun",
          "Mercury",
          "... and 1 more item"
        ],
        "nak_of_occupants": [
          "Mercury",
          "Saturn"
        ],
        "nak_of_lord": [
          "Rahu"
        ],
        "all_significators": [
          "Sun",
          "Mercury",
          "... and 3 more items"
        ],
        "strength_order": [
          "Mercury",
          "Saturn",
          "... and 3 more items"
        ]
      },
      "2": {
        "house": 2,
        "sign_lord": "Mars",
        "occupants": [],
        "nak_of_occupants": [],
        "nak_of_lord": [],
        "all_significators": [
          "Mars"
        ],
        "strength_order": [
          "Mars"
        ]
      },
      "3": {
        "house": 3,
        "sign_lord": "Jupiter",
        "occupants": [
          "Jupiter"
        ],
        "nak_of_occupants": [
          "Sun"
        ],
        "nak_of_lord": [
          "Sun"
        ],
        "all_significators": [
          "Jupiter",
          "Sun"
        ],
        "strength_order": [
          "Sun",
          "Jupiter"
        ]
      },
      "4": {
        "house": 4,
        "sign_lord": "Saturn",
        "occupants": [],
        "nak_of_occupants": [],
        "nak_of_lord": [
          "Saturn"
        ],
        "all_significators": [
          "Saturn"
        ],
        "strength_order": [
          "Saturn"
        ]
      },
      "5": {
        "house": 5,
        "sign_lord": "Saturn",
        "occupants": [],
        "nak_of_occupants": [],
        "nak_of_lord": [
          "Saturn"
        ],
        "all_significators": [
          "Saturn"
        ],
        "strength_order": [
          "Saturn"
        ]
      },
      "6": {
        "house": 6,
        "sign_lord": "Jupiter",
        "occupants": [
          "Rahu"
        ],
        "nak_of_occupants": [
          "Moon",
          "Venus",
          "... and 1 more item"
        ],
        "nak_of_lord": [
          "Sun"
        ],
        "all_significators": [
          "Rahu",
          "Jupiter",
          "... and 4 more items"
        ],
        "strength_order": [
          "Moon",
          "Venus",
          "... and 4 more items"
        ]
      },
      "7": {
        "house": 7,
        "sign_lord": "Mars",
        "occupants": [],
        "nak_of_occupants": [],
        "nak_of_lord": [],
        "all_significators": [
          "Mars"
        ],
        "strength_order": [
          "Mars"
        ]
      },
      "8": {
        "house": 8,
        "sign_lord": "Venus",
        "occupants": [],
        "nak_of_occupants": [],
        "nak_of_lord": [
          "Rahu"
        ],
        "all_significators": [
          "Venus",
          "Rahu"
        ],
        "strength_order": [
          "Rahu",
          "Venus"
        ]
      },
      "9": {
        "house": 9,
        "sign_lord": "Mercury",
        "occupants": [],
        "nak_of_occupants": [],
        "nak_of_lord": [
          "Mercury"
        ],
        "all_significators": [
          "Mercury"
        ],
        "strength_order": [
          "Mercury"
        ]
      },
      "10": {
        "house": 10,
        "sign_lord": "Moon",
        "occupants": [],
        "nak_of_occupants": [],
        "nak_of_lord": [
          "Mars",
          "Jupiter"
        ],
        "all_significators": [
          "Moon",
          "Mars",
          "... and 1 more item"
        ],
        "strength_order": [
          "Mars",
          "Jupiter",
          "... and 1 more item"
        ]
      },
      "11": {
        "house": 11,
        "sign_lord": "Sun",
        "occupants": [
          "Mars"
        ],
        "nak_of_occupants": [],
        "nak_of_lord": [],
        "all_significators": [
          "Mars",
          "Sun"
        ],
        "strength_order": [
          "Mars",
          "Sun"
        ]
      },
      "12": {
        "house": 12,
        "sign_lord": "Mercury",
        "occupants": [
          "Moon",
          "Venus",
          "... and 1 more item"
        ],
        "nak_of_occupants": [
          "Mars",
          "Jupiter",
          "... and 1 more item"
        ],
        "nak_of_lord": [
          "Mercury"
        ],
        "all_significators": [
          "Moon",
          "Venus",
          "... and 5 more items"
        ],
        "strength_order": [
          "Mars",
          "Jupiter",
          "... and 5 more items"
        ]
      }
    },
    "planet_significators": {
      "Sun": {
        "tier1_houses": [
          3
        ],
        "tier2_houses": [
          1
        ],
        "tier3_houses": [
          3,
          6
        ],
        "tier4_houses": [
          11
        ],
        "all_significators": [
          3,
          1,
          "... and 2 more items"
        ]
      },
      "Moon": {
        "tier1_houses": [
          6
        ],
        "tier2_houses": [
          12
        ],
        "tier3_houses": [],
        "tier4_houses": [
          10
        ],
        "all_significators": [
          6,
          12,
          "... and 1 more item"
        ]
      },
      "Mars": {
        "tier1_houses": [
          12
        ],
        "tier2_houses": [
          11
        ],
        "tier3_houses": [
          10
        ],
        "tier4_houses": [
          2,
          7
        ],
        "all_significators": [
          12,
          11,
          "... and 3 more items"
        ]
      },
      "Mercury": {
        "tier1_houses": [
          1
        ],
        "tier2_houses": [
          1
        ],
        "tier3_houses": [
          9,
          12
        ],
        "tier4_houses": [
          9,
          12
        ],
        "all_significators": [
          1,
          9,
          "... and 1 more item"
        ]
      },
      "Jupiter": {
        "tier1_houses": [
          12
        ],
        "tier2_houses": [
          3
        ],
        "tier3_houses": [
          10
        ],
        "tier4_houses": [
          3,
          6
        ],
        "all_significators": [
          12,
          3,
          "... and 2 more items"
        ]
      },
      "Venus": {
        "tier1_houses": [
          6
        ],
        "tier2_houses": [
          12
        ],
        "tier3_houses": [],
        "tier4_houses": [
          1,
          8
        ],
        "all_significators": [
          6,
          12,
          "... and 2 more items"
        ]
      },
      "Saturn": {
        "tier1_houses": [
          1
        ],
        "tier2_houses": [
          1
        ],
        "tier3_houses": [
          4,
          5
        ],
        "tier4_houses": [
          4,
          5
        ],
        "all_significators": [
          1,
          4,
          "... and 1 more item"
        ]
      },
      "Rahu": {
        "tier1_houses": [
          12
        ],
        "tier2_houses": [
          6
        ],
        "tier3_houses": [
          1,
          8
        ],
        "tier4_houses": [],
        "all_significators": [
          12,
          6,
          "... and 2 more items"
        ]
      },
      "Ketu": {
        "tier1_houses": [
          6
        ],
        "tier2_houses": [
          12
        ],
        "tier3_houses": [],
        "tier4_houses": [],
        "all_significators": [
          6,
          12
        ]
      }
    }
  }
}