/api/astro/lal-kitab/chart/1 creditLal Kitab chart
The Lal Kitab kundli: the nine grahas placed in the fixed houses, with each one's pakka ghar. Lal Kitab fixes the houses to the signs: house 1 is ALWAYS Aries, house 2 always Taurus, through to house 12 always Pisces — for every chart, whoever the native is. A planet's house is therefore its sign number, and the ascendant does not move the houses the way it does in Parashari astrology. This means these endpoints will disagree with /api/astro/chart/ and /api/astro/planet-positions/ for almost everyone. That is the system, not an error: they are two different traditions answering two different questions. Every planet comes back with its pakka ghar — the permanent house Lal Kitab assigns it, which is not the same as its sign rulership. Venus rules Taurus and Libra in Parashari, but its pakka ghar is the 7th alone. A graha sitting in its own pakka ghar is said to be awake and able to act fully; `in_pakka_ghar` tells you which are. The positions underneath come from the same engine as /api/astro/planet-positions/, so the longitudes are identical — only the arrangement into houses differs.
https://api.occultapi.com/api/astro/lal-kitab/chart/Authentication
Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonRequest fields
| Field | Type | Required | Notes |
|---|---|---|---|
| date_time | string (date-time) | required | The moment to calculate for, ISO 8601. ALWAYS include an offset or a trailing Z - a value with no zone is read as Asia/Kolkata (UTC+05:30), not UTC, and can return the previous day's result with a 200. '2026-09-01T06:00:00Z' and '2026-09-01 06:00:00' are different instants and give different answers. |
| latitude | number (double) | required | Latitude of the place, in decimal degrees. Positive is north, negative is south. Example: 26.9124 for Jaipur, 40.7128 for New York. Minutes and seconds are not accepted - convert first. min -90 · max 90 |
| longitude | number (double) | required | Longitude of the place, in decimal degrees. Positive is east, negative is west. Example: 75.7873 for Jaipur, -74.0060 for New York. Note the sign: a missing minus puts New York in China. min -180 · max 180 |
| ayanamsa | string | optional | Ayanamsa for the underlying sidereal positions. Lal Kitab itself is house-based and does not prescribe one; this is passed through to the position engine. |
| timezone_as_float | number (double) | optional | UTC offset of the place, in hours, as a decimal. Example: 5.5 for India (UTC+05:30), -5 for New York in winter, 5.75 for Nepal. This is NOT validated against date_time - if the two disagree you get a successful response for the wrong moment, so derive both from the same source. Use the offset in force on that date, not today's: a summer birth in a country with daylight saving needs the summer offset. min -12 · max 14 |
Example request
curl -X POST https://api.occultapi.com/api/astro/lal-kitab/chart/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'Response
{
"data": {
"system": "Lal Kitab",
"house_system": "fixed",
"note": "Houses are fixed to signs: house 1 is always Aries. A planet's house is its sign number, and the ascendant does not move the houses.",
"ascendant": {
"longitude": 177.7489463338338,
"zodiac_name": "Virgo",
"nakshatra": "Chitra",
"pada": 2
},
"planets": [
{
"planet": "sun",
"sign": "Cancer",
"house": 4,
"longitude": 118.395,
"nakshatra": "Aasresha",
"pakka_ghar": [
1
],
"in_pakka_ghar": false
},
{
"planet": "moon",
"sign": "Taurus",
"house": 2,
"longitude": 48.93,
"nakshatra": "Rohini",
"pakka_ghar": [
4
],
"in_pakka_ghar": false
},
{
"planet": "mars",
"sign": "Aries",
"house": 1,
"longitude": 27.487,
"nakshatra": "Krittika",
"pakka_ghar": [
3,
8
],
"in_pakka_ghar": false
},
{
"planet": "mercury",
"sign": "Leo",
"house": 5,
"longitude": 145.446,
"nakshatra": "Poorva Phalguni",
"pakka_ghar": [
6,
7
],
"in_pakka_ghar": false
},
{
"planet": "jupiter",
"sign": "Cancer",
"house": 4,
"longitude": 95.607,
"nakshatra": "Pushyami",
"pakka_ghar": [
2,
5,
9,
12
],
"in_pakka_ghar": false
},
{
"planet": "venus",
"sign": "Cancer",
"house": 4,
"longitude": 97.843,
"nakshatra": "Pushyami",
"pakka_ghar": [
7
],
"in_pakka_ghar": false
},
{
"planet": "saturn",
"sign": "Sagittarius",
"house": 9,
"longitude": 266.148,
"nakshatra": "Poorvaashaadha",
"pakka_ghar": [
8,
10,
11
],
"in_pakka_ghar": false
},
{
"planet": "rahu",
"sign": "Capricorn",
"house": 10,
"longitude": 283.503,
"nakshatra": "Sravanam",
"pakka_ghar": [
12
],
"in_pakka_ghar": false
},
{
"planet": "ketu",
"sign": "Cancer",
"house": 4,
"longitude": 103.503,
"nakshatra": "Pushyami",
"pakka_ghar": [
6
],
"in_pakka_ghar": false
}
],
"houses": [
{
"house": 1,
"sign": "Aries",
"planets": [
"mars"
]
},
{
"house": 2,
"sign": "Taurus",
"planets": [
"moon"
]
},
{
"house": 3,
"sign": "Gemini",
"planets": []
},
{
"house": 4,
"sign": "Cancer",
"planets": [
"sun",
"jupiter",
"venus",
"ketu"
]
},
{
"house": 5,
"sign": "Leo",
"planets": [
"mercury"
]
},
{
"house": 6,
"sign": "Virgo",
"planets": []
},
{
"house": 7,
"sign": "Libra",
"planets": []
},
{
"house": 8,
"sign": "Scorpio",
"planets": []
},
{
"house": 9,
"sign": "Sagittarius",
"planets": [
"saturn"
]
},
{
"house": 10,
"sign": "Capricorn",
"planets": [
"rahu"
]
},
{
"house": 11,
"sign": "Aquarius",
"planets": []
},
{
"house": 12,
"sign": "Pisces",
"planets": []
}
],
"in_pakka_ghar": []
},
"status": 200,
"is_error": false,
"message": "successful"
}Captured from a real call using the exact request above. Results sit under data.
Errors
Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.