/v1/chart/kp-sublord

KP system sub-lords.

What this tells you

KP (Krishnamurti Paddhati) astrology uses Placidus house cusps + sub-lords derived from Vimshottari dasha divisions. The sub-lord is the ultimate significator — used for question-answering (horary/KP). Different from traditional Parashari whole-sign Vedic approach.

Request

All requests require an Authorization header with your dv_live_* API key.

example request

curl "https://api.divyastroapi.com/v1/chart/kp-sublord?date=2026-04-19&time=06%3A30&tz=%2B05%3A30&lat=28.61&lon=77.21" \
  -H "Authorization: Bearer dv_live_0123456789abcdef0123456789abcdef"

Response (200 OK)

Successful requests return a JSON body. Field names are stable across versions.

200 response

{
  "cusps": [
    { "house":  1, "longitude":  92.487, "sign": "Cancer",      "sign_lord": "Moon",    "star_lord": "Saturn",  "sub_lord": "Mercury" },
    { "house":  2, "longitude": 122.148, "sign": "Leo",         "sign_lord": "Sun",     "star_lord": "Venus",   "sub_lord": "Jupiter" },
    { "house":  3, "longitude": 149.876, "sign": "Virgo",       "sign_lord": "Mercury", "star_lord": "Mars",    "sub_lord": "Saturn" }
  ],
  "planets": [
    { "name": "Sun",     "longitude": 272.018, "sign": "Capricorn", "sign_lord": "Saturn",  "star_lord": "Sun",    "sub_lord": "Mercury" },
    { "name": "Moon",    "longitude":  53.772, "sign": "Taurus",    "sign_lord": "Venus",   "star_lord": "Mars",   "sub_lord": "Jupiter" }
  ]
}

Field reference

Every field in the response, with its type, a real example, and what it means.

Field	Type	Meaning
cusps[]	array of 12	KP cusps (Placidus) for each house. example: `[…]`
cusps[].longitude	number	Exact cusp longitude — differs from whole-sign houses. example: `92.487`
cusps[].sign_lord	string	Sign-lord of the cusp. example: `"Moon"`
cusps[].star_lord	string	Nakshatra lord of the cusp. example: `"Saturn"`
cusps[].sub_lord	string	KP sub-lord — the finest-grained significator. example: `"Mercury"`
planets[]	array	Same lord structure for each planet. example: `…`

Usage tips

How to use it

KP-specific apps
Only call this endpoint when your app supports KP-style analysis. Traditional Parashari apps should use /v1/chart/houses instead.

Errors

Every error follows the same envelope. Use the error.code field (not the message) for conditional logic in your integration.

401 Unauthorized

{
  "error": {
    "code": "unauthorized",
    "message": "missing or invalid API key",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

402 Payment Required

{
  "error": {
    "code": "trial_exhausted",
    "message": "your free trial credits are exhausted — pick a plan to continue",
    "top_up_url": "https://divyastroapi.com/pricing",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

429 Too Many Requests

{
  "error": {
    "code": "rate_limited",
    "message": "rate limit exceeded; retry after 12 seconds",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

Try it

Get a dv_live_* key from your dashboard and paste into the cURL snippet above. New accounts get 500 free credits. Sign up.