KP Transit Planets

Endpoint POST https://starsapi.com/api/v3/vedic/kp/transit

Returns the full KP transit snapshot for any moment — all nine planets with sign, house placement (Placidus), nakshatra with pada, and the complete KP lord chain (sign lord, star lord, sub lord, sub-sub lord), plus daily motion, retrograde and combustion flags. The ascendant carries the same lord chain.

Date and time are optional — omit them entirely and the current moment at the given location is used, making this a one-call "sky right now" endpoint for KP work.

All KP endpoints default to the KP Old (Krishnamurti) ayanamsa and mean nodes, matching classical KP ephemeris practice. Both are overridable per request.

Authentication

Method	Example
Header (recommended)	`X-Api-Key: sa_live_xxxxxxxxxxxx`
Bearer	`Authorization: Bearer sa_live_xxxxxxxxxxxx`
Query	`?api_key=sa_live_xxxxxxxxxxxx`

Request body

Field	Type	Required	Description
`latitude`	number	Yes	Decimal degrees.
`longitude`	number	Yes	Decimal degrees.
`timezone`	string	Yes	IANA timezone.
`year`	integer	No	Defaults to the current moment when date/time fields are omitted.
`month`	integer	No	Month, 1–12.
`day`	integer	No	Day of month.
`hour`	integer	No	Hour, 24-hour.
`minute`	integer	No	Minute.
`second`	integer	No	Defaults to `0` when any date/time field is supplied; only when all date/time fields are omitted does it follow the current clock.
`place`	string	No	Echoed in `moment.place`.
`ayanamsa`	string	No	Default `kp_old` (Krishnamurti). Any supported ayanamsa accepted.
`node_type`	string	No	`mean` (default, per classical KP ephemeris practice) or `true`.

Response shape

Field	Type	Description
`moment`	object	The moment used — `date`, `time`, `timezone`, `place`.
`zodiac` / `system`	string	Always `sidereal` / `kp`.
`house_system`	string	`Placidus` (KP standard).
`ascendant`	object	Longitude (decimal + DMS), `degree_in_sign`, sign with lord, nakshatra with lord and pada, `sub_lord`, `sub_sub_lord`.
`planets`	object	Keyed by planet name (Sun…Ketu). Each carries the same positional and KP-lord fields as the ascendant, plus `house` (Placidus placement), `daily_motion`, `is_retrograde`, `is_combust`.

Errors

HTTP	Code	Cause
400	`MISSING_FIELD`	timezone, latitude or longitude absent.
400	`INVALID_DATE`	Bad calendar date.
400	`INVALID_TIME`	Hour/minute/second out of range.
400	`INVALID_TIMEZONE`	Non-IANA timezone.
400	`INVALID_COORDINATE`	Lat/lon out of range.
400	`INVALID_PARAM`	Bad ayanamsa, node_type, or other option.
405	`METHOD_NOT_ALLOWED`	Non-POST request.

# Replace YOUR_API_KEY with the key from your dashboard
curl -X POST "https://starsapi.com/api/v3/vedic/kp/transit" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata"
    }'

const response = await fetch(
  'https://starsapi.com/api/v3/vedic/kp/transit',
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      year: 1990,
      month: 5,
      day: 20,
      hour: 14,
      minute: 30,
      second: 0,
      latitude: 28.6139,
      longitude: 77.209,
      timezone: 'Asia/Kolkata'
    })
  }
);
const result = await response.json();

if (result.success) {
  console.log(result.data);
}

import requests
import os

response = requests.post(
    'https://starsapi.com/api/v3/vedic/kp/transit',
    headers={'X-Api-Key': os.environ['STARSAPI_KEY']},
    json={
        'year': 1990,
        'month': 5,
        'day': 20,
        'hour': 14,
        'minute': 30,
        'second': 0,
        'latitude': 28.6139,
        'longitude': 77.209,
        'timezone': 'Asia/Kolkata'
    }
)
result = response.json()

if result['success']:
    print(result['data'])

<?php
$payload = [
    'year' => 1990,
    'month' => 5,
    'day' => 20,
    'hour' => 14,
    'minute' => 30,
    'second' => 0,
    'latitude' => 28.6139,
    'longitude' => 77.209,
    'timezone' => 'Asia/Kolkata',
];

$ch = curl_init('https://starsapi.com/api/v3/vedic/kp/transit');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-Api-Key: ' . getenv('STARSAPI_KEY'),
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$data = json_decode($response, true);

if ($data['success']) {
    print_r($data['data']);
}

import 'package:http/http.dart' as http;
import 'dart:convert';

Future<Map<String, dynamic>> getAscendant() async {
  final response = await http.post(
    Uri.parse('https://starsapi.com/api/v3/vedic/kp/transit'),
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json',
    },
    body: jsonEncode({
      'year': 1990,
      'month': 5,
      'day': 20,
      'hour': 14,
      'minute': 30,
      'second': 0,
      'latitude': 28.6139,
      'longitude': 77.209,
      'timezone': 'Asia/Kolkata',
    }),
  );
  return jsonDecode(response.body);
}

import Foundation

func getAscendant() async throws -> [String: Any] {
    var request = URLRequest(url: URL(string:
        "https://starsapi.com/api/v3/vedic/kp/transit"
    )!)
    request.httpMethod = "POST"
    request.setValue("YOUR_API_KEY", forHTTPHeaderField: "X-Api-Key")
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    request.httpBody = """
        {
            "year": 1990,
            "month": 5,
            "day": 20,
            "hour": 14,
            "minute": 30,
            "second": 0,
            "latitude": 28.6139,
            "longitude": 77.209,
            "timezone": "Asia/Kolkata"
        }
        """.data(using: .utf8)

    let (data, _) = try await URLSession.shared.data(for: request)
    return try JSONSerialization.jsonObject(with: data) as! [String: Any]
}

import okhttp3.*
import org.json.JSONObject

val client = OkHttpClient()
val JSON = "application/json; charset=utf-8".toMediaType()

fun getAscendant(callback: (JSONObject) -> Unit) {
    val payload = """
    {
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata"
    }
    """.trimIndent()

    val request = Request.Builder()
        .url("https://starsapi.com/api/v3/vedic/kp/transit")
        .addHeader("X-Api-Key", "YOUR_API_KEY")
        .post(payload.toRequestBody(JSON))
        .build()

    client.newCall(request).enqueue(object : Callback {
        override fun onResponse(call: Call, response: Response) {
            callback(JSONObject(response.body!!.string()))
        }
        override fun onFailure(call: Call, e: java.io.IOException) {
            e.printStackTrace()
        }
    })
}

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

func main() {
    payload, _ := json.Marshal(map[string]interface{}{
        "year": 1990,
        "month": 5,
        "day": 20,
        "hour": 14,
        "minute": 30,
        "second": 0,
        "latitude": 28.6139,
        "longitude": 77.209,
        "timezone": "Asia/Kolkata",
    })

    req, _ := http.NewRequest("POST",
        "https://starsapi.com/api/v3/vedic/kp/transit",
        bytes.NewBuffer(payload))
    req.Header.Set("X-Api-Key", os.Getenv("STARSAPI_KEY"))
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result["data"])
}

require 'net/http'
require 'json'

uri = URI('https://starsapi.com/api/v3/vedic/kp/transit')
payload = {
  'year' => 1990,
  'month' => 5,
  'day' => 20,
  'hour' => 14,
  'minute' => 30,
  'second' => 0,
  'latitude' => 28.6139,
  'longitude' => 77.209,
  'timezone' => 'Asia/Kolkata'
}

req = Net::HTTP::Post.new(uri)
req['X-Api-Key'] = ENV['STARSAPI_KEY']
req['Content-Type'] = 'application/json'
req.body = payload.to_json

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
res = http.request(req)

data = JSON.parse(res.body)
puts data['data'] if data['success']

200 RESPONSE

{
  "status": 200,
  "success": true,
  "data": {
    "moment": {
      "date": "1990-05-20",
      "time": "14:30:00",
      "timezone": "Asia/Kolkata",
      "place": null
    },
    "zodiac": "sidereal",
    "system": "kp",
    "house_system": "Placidus",
    "ascendant": {
      "longitude": 156.3446,
      "longitude_dms": "156°20'41\"",
      "degree_in_sign": 6.3446,
      "sign": "Virgo",
      "sign_lord": "Mercury",
      "nakshatra": "Uttara Phalguni",
      "nakshatra_lord": "Sun",
      "nakshatra_pada": 3,
      "sub_lord": "Mercury",
      "sub_sub_lord": "Rahu"
    },
    "planets": {
      "Sun": {
        "name": "Sun",
        "longitude": 35.4636,
        "longitude_dms": "35°27'49\"",
        "degree_in_sign": 5.4636,
        "daily_motion": 0.962625,
        "sign": "Taurus",
        "sign_lord": "Venus",
        "house": 9,
        "nakshatra": "Krittika",
        "nakshatra_lord": "Sun",
        "nakshatra_pada": 3,
        "sub_lord": "Mercury",
        "sub_sub_lord": "Ketu",
        "is_retrograde": false,
        "is_combust": false
      },
      "Saturn": {
        "name": "Saturn",
        "longitude": 271.5192,
        "longitude_dms": "271°31'9\"",
        "degree_in_sign": 1.5192,
        "daily_motion": -0.02457,
        "sign": "Capricorn",
        "sign_lord": "Saturn",
        "house": 4,
        "nakshatra": "Uttara Ashadha",
        "nakshatra_lord": "Sun",
        "nakshatra_pada": 2,
        "sub_lord": "Jupiter",
        "sub_sub_lord": "Saturn",
        "is_retrograde": true,
        "is_combust": false
      },
      "…": "Moon, Mars, Mercury, Jupiter, Venus, Rahu, Ketu follow the same shape"
    }
  },
  "meta": { "endpoint": "/api/v3/vedic/kp/transit", "version": "3.0", "ayanamsa": { "name": "Krishnamurti (KP Old)", "value": 23.629105 }, "node_type": "mean" }
}