Astrologics API

KP

Krishnamurti Paddhati: cusps and sub lords, 4-step significators, ruling planets, horary.

KP chart: cusps and planets with star, sub and sub-sub lords

POST/v1/kp/chart

2 credits · Secret key (test or live) · getKpChart

Request body

  • birth Birth required
    • date string (date) required

      e.g. "1990-08-13"

    • time string

      pattern ^([01]\d|2[0-3]):[0-5]\d(:[0-5]\d)?$ · e.g. "06:30"

    • time_accuracy string

      With "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"

    • place Coordinates or object or object required

      Coordinates, 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:

      1. Coordinates
        Fields
        • latitude number required

          ≥ -90 · ≤ 90

        • longitude number required

          ≥ -180 · ≤ 180

        No other fields are accepted.

      2. object
        Fields
        • place_id string required

        No other fields are accepted.

      3. object
        Fields
        • query string required

          at least 2 characters · at most 120 characters

        No other fields are accepted.

    • timezone string

      "auto" (from coordinates AND date), an IANA name, or a fixed offset like "+05:30".

      default "auto"

    No other fields are accepted.

  • options Options
    • ayanamsa string

      Each 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_system string

      one of whole_sign · default "whole_sign"

    • node string

      one of true, mean · default "true"

    • lang string

      one of en, hi · default "en"

    • view string

      compact drops labels and prose — for LLM callers.

      one of full, compact · default "full"

    No other fields are accepted.

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

  • ayanamsa object required
    • id string required
    • degrees number or null required

      One of:

      1. number
      2. null
  • cusps array of object required
    • house integer required
    • longitude number required
    • sign string required
    • nakshatra string required
    • star_lord string required
    • sub_lord string required
    • sub_sub_lord string required
  • planets array of object required
    • id string required
    • longitude number required
    • sign string required
    • nakshatra string required
    • star_lord string required
    • sub_lord string required
    • sub_sub_lord string required
    • house integer required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/kp/chart' \
  -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/chart", {
  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/chart",
    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/chart');
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 · 5,322 characters
{
  "data": {
    "ayanamsa": {
      "id": "kp_new",
      "degrees": null
    },
    "cusps": [
      {
        "house": 1,
        "longitude": 124.37,
        "sign": "leo",
        "nakshatra": "magha",
        "star_lord": "ketu",
        "sub_lord": "moon",
        "sub_sub_lord": "mercury"
      },
      {
        "house": 2,
        "longitude": 150.1736,
        "sign": "virgo",
        "nakshatra": "uttara_phalguni",
        "star_lord": "sun",
        "sub_lord": "rahu",
        "sub_sub_lord": "mercury"
      },
      {
        "house": 3,
        "longitude": 179.8618,
        "sign": "virgo",
        "nakshatra": "chitra",
        "star_lord": "mars",
        "sub_lord": "saturn",
        "sub_sub_lord": "jupiter"
      },
      {
        "house": 4,
        "longitude": 212.1161,
        "sign": "scorpio",
        "nakshatra": "vishakha",
        "star_lord": "jupiter",
        "sub_lord": "rahu",
        "sub_sub_lord": "saturn"
      },
      {
        "house": 5,
        "longitude": 244.5106,
        "sign": "sagittarius",
        "nakshatra": "mula",
        "star_lord": "ketu",
        "sub_lord": "moon",
        "sub_sub_lord": "ketu"
      },
      {
        "house": 6,
        "longitude": 275.4259,
        "sign": "capricorn",
        "nakshatra": "uttara_ashadha",
        "star_lord": "sun",
        "sub_lord": "mercury",
        "sub_sub_lord": "ketu"
      },
      {
        "house": 7,
        "longitude": 304.37,
        "sign": "aquarius",
        "nakshatra": "dhanishta",
        "star_lord": "mars",
        "sub_lord": "venus",
        "sub_sub_lord": "saturn"
      },
      {
        "house": 8,
        "longitude": 330.1736,
        "sign": "pisces",
        "nakshatra": "purva_bhadrapada",
        "star_lord": "jupiter",
        "sub_lord": "moon",
        "sub_sub_lord": "mercury"
      },
      {
        "house": 9,
        "longitude": 359.8618,
        "sign": "pisces",
        "nakshatra": "revati",
        "star_lord": "mercury",
        "sub_lord": "saturn",
        "sub_sub_lord": "jupiter"
      },
      {
        "house": 10,
        "longitude": 32.1161,
        "sign": "taurus",
        "nakshatra": "krittika",
        "star_lord": "sun",
        "sub_lord": "jupiter",
        "sub_sub_lord": "venus"
      },
      {
        "house": 11,
        "longitude": 64.5106,
        "sign": "gemini",
        "nakshatra": "mrigashira",
        "star_lord": "mars",
        "sub_lord": "venus",
        "sub_sub_lord": "mercury"
      },
      {
        "house": 12,
        "longitude": 95.4259,
        "sign": "cancer",
        "nakshatra": "pushya",
        "star_lord": "saturn",
        "sub_lord": "saturn",
        "sub_sub_lord": "jupiter"
      }
    ],
    "planets": [
      {
        "id": "sun",
        "longitude": 116.408,
        "sign": "cancer",
        "nakshatra": "ashlesha",
        "star_lord": "mercury",
        "sub_lord": "jupiter",
        "sub_sub_lord": "saturn",
        "house": 12
      },
      {
        "id": "moon",
        "longitude": 18.1896,
        "sign": "aries",
        "nakshatra": "bharani",
        "star_lord": "venus",
        "sub_lord": "rahu",
        "sub_sub_lord": "rahu",
        "house": 9
      },
      {
        "id": "mars",
        "longitude": 26.3211,
        "sign": "aries",
        "nakshatra": "bharani",
        "star_lord": "venus",
        "sub_lord": "ketu",
        "sub_sub_lord": "rahu",
        "house": 9
      },
      {
        "id": "mercury",
        "longitude": 143.7314,
        "sign": "leo",
        "nakshatra": "purva_phalguni",
        "star_lord": "venus",
        "sub_lord": "saturn",
        "sub_sub_lord": "jupiter",
        "house": 1
      },
      {
        "id": "jupiter",
        "longitude": 95.2341,
        "sign": "cancer",
        "nakshatra": "pushya",
        "star_lord": "saturn",
        "sub_lord": "saturn",
        "sub_sub_lord": "jupiter",
        "house": 11
      },
      {
        "id": "venus",
        "longitude": 95.2923,
        "sign": "cancer",
        "nakshatra": "pushya",
        "star_lord": "saturn",
        "sub_lord": "saturn",
        "sub_sub_lord": "jupiter",
        "house": 11
      },
      {
        "id": "saturn",
        "longitude": 266.3664,
        "sign": "sagittarius",
        "nakshatra": "purva_ashadha",
        "star_lord": "venus",
        "sub_lord": "ketu",
        "sub_sub_lord": "jupiter",
        "house": 5
      },
      {
        "id": "rahu",
        "longitude": 283.6614,
        "sign": "capricorn",
        "nakshatra": "shravana",
        "star_lord": "moon",
        "sub_lord": "rahu",
        "sub_sub_lord": "moon",
        "house": 6
      },
      {
        "id": "ketu",
        "longitude": 103.6614,
        "sign": "cancer",
        "nakshatra": "pushya",
        "star_lord": "saturn",
        "sub_lord": "rahu",
        "sub_sub_lord": "saturn",
        "house": 12
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.9.28",
    "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

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

KP 4-step significators and house groups

POST/v1/kp/significators

2 credits · Secret key (test or live) · getKpSignificators

Request body

  • birth Birth required
    • date string (date) required

      e.g. "1990-08-13"

    • time string

      pattern ^([01]\d|2[0-3]):[0-5]\d(:[0-5]\d)?$ · e.g. "06:30"

    • time_accuracy string

      With "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"

    • place Coordinates or object or object required

      Coordinates, 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:

      1. Coordinates
        Fields
        • latitude number required

          ≥ -90 · ≤ 90

        • longitude number required

          ≥ -180 · ≤ 180

        No other fields are accepted.

      2. object
        Fields
        • place_id string required

        No other fields are accepted.

      3. object
        Fields
        • query string required

          at least 2 characters · at most 120 characters

        No other fields are accepted.

    • timezone string

      "auto" (from coordinates AND date), an IANA name, or a fixed offset like "+05:30".

      default "auto"

    No other fields are accepted.

  • options Options
    • ayanamsa string

      Each 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_system string

      one of whole_sign · default "whole_sign"

    • node string

      one of true, mean · default "true"

    • lang string

      one of en, hi · default "en"

    • view string

      compact drops labels and prose — for LLM callers.

      one of full, compact · default "full"

    No other fields are accepted.

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

  • planets array of object required
    • id string required
    • a array of integer required
    • b array of integer required
    • c array of integer required
    • d array of integer required
    • houses array of integer required
    • sub_lord_houses array of integer required
  • groups array of object required
    • id string required
    • houses array of integer required
    • strong array of string required
    • partial array of object required
      Fields
      • planet string required
      • houses array 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,987 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.9.28",
    "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

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

The seven KP ruling planets at a moment and place

GET/v1/kp/ruling-planets

1 credit · Secret or publishable key · getKpRulingPlanets

Parameters

NameInTypeNotes
datetime requiredquerystring (date-time)The moment, ISO 8601 with a zone (e.g. 2026-10-02T06:00:00Z).
lat requiredquerynumber ≥ -90 · ≤ 90
lon requiredquerynumber ≥ -180 · ≤ 180

Response

JSON { data, meta, warnings }, where data is:

  • at string (date-time) required
  • day_lord string required
  • lagna object required
    • sign_lord string required
    • star_lord string required
    • sub_lord string required
  • moon object required
    • sign_lord string required
    • star_lord string required
    • sub_lord string required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl 'https://api.astrologics.in/v1/kp/ruling-planets?datetime=2026-10-02T06:00:00Z&lat=28.6139&lon=77.209' \
  -H 'Authorization: Bearer al_test_YOUR_KEY'
Node.js
const res = await fetch("https://api.astrologics.in/v1/kp/ruling-planets?datetime=2026-10-02T06:00:00Z&lat=28.6139&lon=77.209", {
  headers: { Authorization: "Bearer al_test_YOUR_KEY" },
});
console.log(JSON.stringify(await res.json(), null, 2));
Python
import json
import urllib.error
import urllib.request

req = urllib.request.Request(
    "https://api.astrologics.in/v1/kp/ruling-planets?datetime=2026-10-02T06:00:00Z&lat=28.6139&lon=77.209",
    method="GET",
    headers={"Authorization": "Bearer al_test_YOUR_KEY"},
)
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/ruling-planets?datetime=2026-10-02T06:00:00Z&lat=28.6139&lon=77.209');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 461 characters
{
  "data": {
    "at": "2026-10-02T06:00:00.000Z",
    "day_lord": "venus",
    "lagna": {
      "sign_lord": "mars",
      "star_lord": "mercury",
      "sub_lord": "sun"
    },
    "moon": {
      "sign_lord": "venus",
      "star_lord": "mars",
      "sub_lord": "jupiter"
    }
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.9.28",
    "mode": "live",
    "credits_charged": 1
  },
  "warnings": []
}
Try it

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

KP horary (prashna) for a number from 1 to 249

GET/v1/kp/horary

2 credits · Secret or publishable key · getKpHorary

Parameters

NameInTypeNotes
number requiredqueryintegerThe number the querent chose, 1–249. ≥ 1 · ≤ 249
datetime requiredquerystring (date-time)The moment, ISO 8601 with a zone (e.g. 2026-10-02T06:00:00Z).
lat requiredquerynumber ≥ -90 · ≤ 90
lon requiredquerynumber ≥ -180 · ≤ 180

Response

JSON { data, meta, warnings }, where data is:

  • number integer required
  • at string (date-time) required
  • division object required
    • start number required
    • end number required
    • sign string required
    • sign_lord string required
    • nakshatra string required
    • star_lord string required
    • sub_lord string required
  • ruling_planets object or null required

    One of:

    1. object
      Fields
      • day_lord string required
      • lagna object required
        Fields
        • sign_lord string required
        • star_lord string required
        • sub_lord string required
      • moon object required
        Fields
        • sign_lord string required
        • star_lord string required
        • sub_lord string required
    2. null

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl 'https://api.astrologics.in/v1/kp/horary?number=123&datetime=2026-10-02T06:00:00Z&lat=28.6139&lon=77.209' \
  -H 'Authorization: Bearer al_test_YOUR_KEY'
Node.js
const res = await fetch("https://api.astrologics.in/v1/kp/horary?number=123&datetime=2026-10-02T06:00:00Z&lat=28.6139&lon=77.209", {
  headers: { Authorization: "Bearer al_test_YOUR_KEY" },
});
console.log(JSON.stringify(await res.json(), null, 2));
Python
import json
import urllib.error
import urllib.request

req = urllib.request.Request(
    "https://api.astrologics.in/v1/kp/horary?number=123&datetime=2026-10-02T06:00:00Z&lat=28.6139&lon=77.209",
    method="GET",
    headers={"Authorization": "Bearer al_test_YOUR_KEY"},
)
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/horary?number=123&datetime=2026-10-02T06:00:00Z&lat=28.6139&lon=77.209');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 490 characters
{
  "data": {
    "number": 123,
    "at": "2026-10-02T06:00:00.000Z",
    "division": {
      "start": 176.111111,
      "end": 177.888889,
      "sign": "virgo",
      "sign_lord": "mercury",
      "nakshatra": "chitra",
      "star_lord": "mars",
      "sub_lord": "jupiter"
    },
    "ruling_planets": null
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.9.28",
    "mode": "live",
    "credits_charged": 2
  },
  "warnings": []
}
Try it

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one