KP Significators API
KP 4-step significators and house groups
POST/v1/kp/significators
2 credits · Secret key (test or live) · getKpSignificators
Request body
birthBirth requireddatestring (date) requirede.g.
"1990-08-13"timestringpattern
^([01]\d|2[0-3]):[0-5]\d(:[0-5]\d)?$· e.g."06:30"time_accuracystringWith "unknown", lagna- and house-dependent fields are omitted and listed in warnings — never filled with a noon default.
one of
exact,approximate,unknown· default"exact"placeCoordinates or object or object requiredCoordinates, a place_id from /v1/places/search, or a free-text query. A vague query returns 422 place_ambiguous with candidates; the API never guesses.
One of:
- Coordinates
Fields
latitudenumber required≥ -90 · ≤ 90
longitudenumber required≥ -180 · ≤ 180
No other fields are accepted.
- object
Fields
place_idstring required
No other fields are accepted.
- object
Fields
querystring requiredat least 2 characters · at most 120 characters
No other fields are accepted.
- Coordinates
timezonestring"auto" (from coordinates AND date), an IANA name, or a fixed offset like "+05:30".
default
"auto"
No other fields are accepted.
optionsOptionsayanamsastringEach system is its Swiss Ephemeris definition (a constant offset from Lahiri). Applies to chart operations; KP operations always use KP-New and the personal muhurat stays Lahiri. meta.ayanamsa names the system used.
one of
lahiri,raman,krishnamurti,yukteshwar,fagan_bradley· default"lahiri"house_systemstringone of
whole_sign· default"whole_sign"nodestringThe Rahu/Ketu the chart uses: the true (osculating) node, as Swiss Ephemeris and Drik Panchang define it, or the mean node. meta.node names the one used. POST /v1/planets/positions always returns both.
one of
true,mean· default"true"langstringone of
en,hi· default"en"viewstringcompact drops labels and prose — for LLM callers.
one of
full,compact· default"full"tonestringdescriptive: the prose fields (tithi.note, tara descriptions, the timing summary and insights, natal-transit descriptions, transit-event notes) carry reviewed descriptive sentences, attributed to the tradition and with no instructions, in options.lang. Ids, scores and every other value are unchanged. Applies to getPanchang, getFavourableDays, getPersonalTiming, getDashaTransitConfluence, getNatalTransits and listPlanetaryEvents (and those inside a bundle); elsewhere it changes nothing.
one of
default,descriptive· default"default"dasha_yearnumberDays in a Vimshottari year: 365.25 (Julian, the default), 365.2422 (tropical) or 360 (savana). Applies to /v1/dasha/vimshottari and /v1/dasha/vimshottari/current; data.basis.year_days names the one used.
one of
365.25,365.2422,360· default365.25
No other fields are accepted.
No other fields are accepted.
Response
JSON { data, meta, warnings }, where data is:
planetsarray of object requiredidstring requiredaarray of integer requiredbarray of integer requiredcarray of integer requireddarray of integer requiredhousesarray of integer requiredsub_lord_housesarray of integer required
groupsarray of object requiredidstring requiredhousesarray of integer requiredstrongarray of string requiredpartialarray of object requiredFields
planetstring requiredhousesarray of integer required
Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.
Example request
curl -X POST 'https://api.astrologics.in/v1/kp/significators' \
-H 'Authorization: Bearer al_test_YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}}}'Node.js
const res = await fetch("https://api.astrologics.in/v1/kp/significators", {
method: "POST",
headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
body: JSON.stringify({
"birth": {
"date": "1990-08-13",
"time": "06:30",
"place": {
"latitude": 28.6139,
"longitude": 77.209
}
}
}),
});
console.log(JSON.stringify(await res.json(), null, 2));Python
import json
import urllib.error
import urllib.request
body = {
"birth": {
"date": "1990-08-13",
"time": "06:30",
"place": {
"latitude": 28.6139,
"longitude": 77.209,
},
},
}
req = urllib.request.Request(
"https://api.astrologics.in/v1/kp/significators",
method="POST",
headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
data=json.dumps(body).encode(),
)
try:
with urllib.request.urlopen(req) as res:
print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
print(err.code, err.read().decode())PHP
<?php
$ch = curl_init('https://api.astrologics.in/v1/kp/significators');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{"birth":{"date":"1990-08-13","time":"06:30","place":{"latitude":28.6139,"longitude":77.209}}}',
CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;Example response
200 OK · 14,988 characters
{
"data": {
"planets": [
{
"id": "sun",
"a": [
1
],
"b": [
2,
3,
11
],
"c": [
12
],
"d": [
1
],
"houses": [
1,
2,
3,
11,
12
],
"sub_lord_houses": [
5,
8,
9,
11
]
},
{
"id": "moon",
"a": [
11
],
"b": [
10
],
"c": [
9
],
"d": [
12
],
"houses": [
9,
10,
11,
12
],
"sub_lord_houses": [
6
]
},
{
"id": "mars",
"a": [
11
],
"b": [
10
],
"c": [
9
],
"d": [
4
],
"houses": [
4,
9,
10,
11
],
"sub_lord_houses": [
12
]
},
{
"id": "mercury",
"a": [
11
],
"b": [
10
],
"c": [
1
],
"d": [
2,
3,
11
],
"houses": [
1,
2,
3,
10,
11
],
"sub_lord_houses": [
5,
6,
7
]
},
{
"id": "jupiter",
"a": [
5
],
"b": [
6,
7
],
"c": [
11
],
"d": [
5,
8,
9
],
"houses": [
5,
6,
7,
8,
9,
11
],
"sub_lord_houses": [
5,
6,
7
]
},
{
"id": "venus",
"a": [
5
],
"b": [
6,
7
],
"c": [
11
],
"d": [
10
],
"houses": [
5,
6,
7,
10,
11
],
"sub_lord_houses": [
5,
6,
7
]
},
{
"id": "saturn",
"a": [
11
],
"b": [
10
],
"c": [
5
],
"d": [
6,
7
],
"houses": [
5,
6,
7,
10,
11
],
"sub_lord_houses": [
12
]
},
{
"id": "rahu",
"a": [
9
],
"b": [
12
],
"c": [
6
],
"d": [],
"houses": [
6,
9,
12
],
"sub_lord_houses": [
6
]
},
{
"id": "ketu",
"a": [
5
],
"b": [
6,
7
],
"c": [
12
],
"d": [],
"houses": [
5,
6,
7,
12
],
"sub_lord_houses": [
6
]
}
],
"groups": [
{
"id": "marriage",
"houses": [
2,
7,
11
],
"strong": [],
"partial": [
{
"planet": "sun",
"houses": [
2,
11
]
},
{
"planet": "moon",
"houses": [
11
]
},
{
"planet": "mars",
"houses": [
11
]
},
{
"planet": "mercury",
"houses": [
2,
11
]
},
{
"planet": "jupiter",
"houses": [
7,
11
]
},
{
"planet": "venus",
"houses": [
7,
11
]
},
{
"planet": "saturn",
"houses": [
7,
11
]
},
{
"planet": "ketu",
"houses": [
7
]
}
]
},
{
"id": "job",
"houses": [
2,
6,
10,
11
],
"strong": [],
"partial": [
{
"planet": "sun",
"houses": [
2,
11
]
},
{
"planet": "moon",
"houses": [
10,
11
]
},
{
"planet": "mars",
"houses": [
10,
11
]
},
{
"planet": "mercury",
"houses": [
2,
10,
11
]
},
{
"planet": "jupiter",
"houses": [
6,
11
]
},
{
"planet": "venus",
"houses": [
6,
10,
11
]
},
{
"planet": "saturn",
"houses": [
6,
10,
11
]
},
{
"planet": "rahu",
"houses": [
6
]
},
{
"planet": "ketu",
"houses": [
6
]
}
]
},
{
"id": "business",
"houses": [
2,
7,
10,
11
],
"strong": [],
"partial": [
{
"planet": "sun",
"houses": [
2,
11
]
},
{
"planet": "moon",
"houses": [
10,
11
]
},
{
"planet": "mars",
"houses": [
10,
11
]
},
{
"planet": "mercury",
"houses": [
2,
10,
11
]
},
{
"planet": "jupiter",
"houses": [
7,
11
]
},
{
"planet": "venus",
"houses": [
7,
10,
11
]
},
{
"planet": "saturn",
"houses": [
7,
10,
11
]
},
{
"planet": "ketu",
"houses": [
7
]
}
]
},
{
"id": "wealth",
"houses": [
2,
6,
11
],
"strong": [],
"partial": [
{
"planet": "sun",
"houses": [
2,
11
]
},
{
"planet": "moon",
"houses": [
11
]
},
{
"planet": "mars",
"houses": [
11
]
},
{
"planet": "mercury",
"houses": [
2,
11
]
},
{
"planet": "jupiter",
"houses": [
6,
11
]
},
{
"planet": "venus",
"houses": [
6,
11
]
},
{
"planet": "saturn",
"houses": [
6,
11
]
},
{
"planet": "rahu",
"houses": [
6
]
},
{
"planet": "ketu",
"houses": [
6
]
}
]
},
{
"id": "children",
"houses": [
2,
5,
11
],
"strong": [],
"partial": [
{
"planet": "sun",
"houses": [
2,
11
]
},
{
"planet": "moon",
"houses": [
11
]
},
{
"planet": "mars",
"houses": [
11
]
},
{
"planet": "mercury",
"houses": [
2,
11
]
},
{
"planet": "jupiter",
"houses": [
5,
11
]
},
{
"planet": "venus",
"houses": [
5,
11
]
},
{
"planet": "saturn",
"houses": [
5,
11
]
},
{
"planet": "ketu",
"houses": [
5
]
}
]
},
{
"id": "education",
"houses": [
4,
9,
11
],
"strong": [
"mars"
],
"partial": [
{
"planet": "sun",
"houses": [
11
]
},
{
"planet": "moon",
"houses": [
9,
11
]
},
{
"planet": "mercury",
"houses": [
11
]
},
{
"planet": "jupiter",
"houses": [
9,
11
]
},
{
"planet": "venus",
"houses": [
11
]
},
{
"planet": "saturn",
"houses": [
11
]
},
{
"planet": "rahu",
"houses": [
9
]
}
]
},
{
"id": "property",
"houses": [
4,
11,
12
],
"strong": [],
"partial": [
{
"planet": "sun",
"houses": [
11,
12
]
},
{
"planet": "moon",
"houses": [
11,
12
]
},
{
"planet": "mars",
"houses": [
4,
11
]
},
{
"planet": "mercury",
"houses": [
11
]
},
{
"planet": "jupiter",
"houses": [
11
]
},
{
"planet": "venus",
"houses": [
11
]
},
{
"planet": "saturn",
"houses": [
11
]
},
{
"planet": "rahu",
"houses": [
12
]
},
{
"planet": "ketu",
"houses": [
12
]
}
]
},
{
"id": "foreign",
"houses": [
3,
9,
12
],
"strong": [],
"partial": [
{
"planet": "sun",
"houses": [
3,
12
]
},
{
"planet": "moon",
"houses": [
9,
12
]
},
{
"planet": "mars",
"houses": [
9
]
},
{
"planet": "mercury",
"houses": [
3
]
},
{
"planet": "jupiter",
"houses": [
9
]
},
{
"planet": "rahu",
"houses": [
9,
12
]
},
{
"planet": "ketu",
"houses": [
12
]
}
]
},
{
"id": "health",
"houses": [
1,
5,
11
],
"strong": [],
"partial": [
{
"planet": "sun",
"houses": [
1,
11
]
},
{
"planet": "moon",
"houses": [
11
]
},
{
"planet": "mars",
"houses": [
11
]
},
{
"planet": "mercury",
"houses": [
1,
11
]
},
{
"planet": "jupiter",
"houses": [
5,
11
]
},
{
"planet": "venus",
"houses": [
5,
11
]
},
{
"planet": "saturn",
"houses": [
5,
11
]
},
{
"planet": "ketu",
"houses": [
5
]
}
]
},
{
"id": "litigation",
"houses": [
6,
11
],
"strong": [
"jupiter",
"venus",
"saturn"
],
"partial": [
{
"planet": "sun",
"houses": [
11
]
},
{
"planet": "moon",
"houses": [
11
]
},
{
"planet": "mars",
"houses": [
11
]
},
{
"planet": "mercury",
"houses": [
11
]
},
{
"planet": "rahu",
"houses": [
6
]
},
{
"planet": "ketu",
"houses": [
6
]
}
]
}
]
},
"meta": {
"request_id": "req_example",
"api_version": "v1",
"engine_version": "2026.10.10",
"mode": "live",
"credits_charged": 2,
"ayanamsa": "lahiri",
"house_system": "whole_sign",
"node": "true",
"timezone_used": {
"name": "Asia/Kolkata",
"utc_offset": "+05:30",
"source": "auto"
}
},
"warnings": []
}Try it
More in KP
- KP Chart API (Star, Sub and Sub-Sub Lords): KP chart: cusps and planets with star, sub and sub-sub lords
- KP Ruling Planets API: The seven KP ruling planets at a moment and place
- KP Horary (Prashna) API: KP horary (prashna) for a number from 1 to 249
- KP Sub Lord Changes API: When each planet changes sign, star lord or sub lord over a range
- KP Ruling Planet Intervals API: The seven KP ruling planets over a window, as intervals