Copy page

Copy page as Markdown for LLMs

View as Markdown

View this page as plain text


Open in ChatGPT

Ask ChatGPT about this page

Open in Claude

Ask Claude about this page

Planetary Positions API

The Planetary Positions API provides planetary data for Jaimini Astrology, revealing the positions, degrees, nakshatras, and karakamsa significations of each planet and house. This API helps interpret the spiritual and material influences of celestial bodies within the Jaimini system of Indian Astrology.


Step-by-Step Planetary Positions API Postman Testing Integration

You can follow the official guide here:

Step by Step Planetary Positions API Postman Testing Integration


Supported Language Codes

Source:
https://support.divineapi.com/general-api-support/translating-an-indian-vedic-apis-into-a-different-language

CodeLanguage
enEnglish
hiHindi
bnBengali
maMarathi
tmTamil
tlTelugu
mlMalayalam
knKannada

Pass lan in the request body to get the response in that language. Default is en.


API Endpoint

POST https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions

This endpoint returns detailed planetary position data in response.


Headers

NameTypeDescription
Authorization*StringYour API Access Token. Example: Bearer {token}

Request Body

NameTypeDescription
api_key*StringYour API key.
full_name*StringFull name, e.g. Rahul Kumar.
day*IntegerDate of birth, e.g. 24.
month*IntegerMonth of birth, e.g. 05.
year*IntegerYear of birth, e.g. 2023.
hour*IntegerHour of birth (24-hour format), e.g. 14.
min*IntegerMinute, e.g. 40.
sec*IntegerSecond, e.g. 43.
gender*StringGender, e.g. male.
place*StringPlace of birth, e.g. New Delhi.
lat*FloatLatitude, e.g. 28.7041.
lon*FloatLongitude, e.g. 77.1025.
tzone*FloatTimezone, e.g. 5.5. Timezone List
lanStringLanguage code as per the table above. Default is en.
node_typeStringtruenode or meannode, default is meannode

200: OK Jaimini Astrology Planetary Positions Fetched Successfully

{
    "success": 1,
    "data": [
        {
            "name": "Ascendant",
            "name_lan": "Ascendant",
            "full_degree": "67.9760792",
            "sign": "Gemini",
            "sign_no": 3,
            "longitude": "7:58:34",
            "house": 1,
            "nakshatra": "Ardra",
            "nakshatra_pada": 1,
            "nakshatra_no": 6,
            "karakamsha": "",
            "karakamsha_functionality": ""
        },
        {
            "name": "Sun",
            "name_lan": "Sun",
            "full_degree": "96.5115748",
            "sign": "Cancer",
            "sign_no": 4,
            "longitude": "6:30:42",
            "house": 2,
            "nakshatra": "Pushya",
            "nakshatra_pada": 1,
            "nakshatra_no": 8,
            "karakamsha": "Darakaraka",
            "karakamsha_functionality": "Spouse/Partners"
        },
        {
            "name": "Moon",
            "name_lan": "Moon",
            "full_degree": "77.2513346",
            "sign": "Gemini",
            "sign_no": 3,
            "longitude": "17:15:5",
            "house": 1,
            "nakshatra": "Ardra",
            "nakshatra_pada": 4,
            "nakshatra_no": 6,
            "karakamsha": "Matrukaraka",
            "karakamsha_functionality": "Mother/Immovable Assets/Vehicles"
        },
        {
            "name": "Mars",
            "name_lan": "Mars",
            "full_degree": "146.7831714",
            "sign": "Leo",
            "sign_no": 5,
            "longitude": "26:46:59",
            "house": 3,
            "nakshatra": "Uttara Phalguni",
            "nakshatra_pada": 1,
            "nakshatra_no": 12,
            "karakamsha": "Atmakaraka",
            "karakamsha_functionality": "Self"
        },
        {
            "name": "Mercury",
            "name_lan": "Mercury",
            "full_degree": "110.3021979",
            "sign": "Cancer",
            "sign_no": 4,
            "longitude": "20:18:8",
            "house": 2,
            "nakshatra": "Ashlesha",
            "nakshatra_pada": 2,
            "nakshatra_no": 9,
            "karakamsha": "Bhratrukaraka",
            "karakamsha_functionality": "Brothers/coworkers/friends"
        },
        {
            "name": "Venus",
            "name_lan": "Venus",
            "full_degree": "56.7689001",
            "sign": "Taurus",
            "sign_no": 2,
            "longitude": "26:46:8",
            "house": 12,
            "nakshatra": "Mrigashira",
            "nakshatra_pada": 2,
            "nakshatra_no": 5,
            "karakamsha": "Amatyakaraka",
            "karakamsha_functionality": "Ministers and Advisors"
        },
        {
            "name": "Jupiter",
            "name_lan": "Jupiter",
            "full_degree": "75.6142000",
            "sign": "Gemini",
            "sign_no": 3,
            "longitude": "15:36:51",
            "house": 1,
            "nakshatra": "Ardra",
            "nakshatra_pada": 3,
            "nakshatra_no": 6,
            "karakamsha": "Putrakaraka",
            "karakamsha_functionality": "Children/Education/Creative Abilities"
        },
        {
            "name": "Saturn",
            "name_lan": "Saturn",
            "full_degree": "337.6326830",
            "sign": "Pisces",
            "sign_no": 12,
            "longitude": "7:37:58",
            "house": 10,
            "nakshatra": "Uttara Bhadrapada",
            "nakshatra_pada": 2,
            "nakshatra_no": 26,
            "karakamsha": "Gnatikaraka",
            "karakamsha_functionality": "Debts/Fears/Loss/Faliures"
        },
        {
            "name": "Rahu",
            "name_lan": "Rahu",
            "full_degree": "326.5164966",
            "sign": "Aquarius",
            "sign_no": 11,
            "longitude": "26:30:59",
            "house": 9,
            "nakshatra": "Purva Bhadrapada",
            "nakshatra_pada": 2,
            "nakshatra_no": 25,
            "karakamsha": "",
            "karakamsha_functionality": ""
        },
        {
            "name": "Ketu",
            "name_lan": "Ketu",
            "full_degree": 146.51649659999998,
            "sign": "Leo",
            "sign_no": 5,
            "longitude": "26:30:59",
            "house": 3,
            "nakshatra": "Purva Phalguni",
            "nakshatra_pada": 4,
            "nakshatra_no": 11,
            "karakamsha": "",
            "karakamsha_functionality": ""
        },
        {
            "name": "Uranus",
            "name_lan": "Uranus",
            "full_degree": "36.4266973",
            "sign": "Taurus",
            "sign_no": 2,
            "longitude": "6:25:36",
            "house": 12,
            "nakshatra": "Krittika",
            "nakshatra_pada": 3,
            "nakshatra_no": 3,
            "karakamsha": "",
            "karakamsha_functionality": ""
        },
        {
            "name": "Neptune",
            "name_lan": "Neptune",
            "full_degree": "337.8703452",
            "sign": "Pisces",
            "sign_no": 12,
            "longitude": "7:52:13",
            "house": 10,
            "nakshatra": "Uttara Bhadrapada",
            "nakshatra_pada": 2,
            "nakshatra_no": 26,
            "karakamsha": "",
            "karakamsha_functionality": ""
        },
        {
            "name": "Pluto",
            "name_lan": "Pluto",
            "full_degree": "278.4205667",
            "sign": "Capricorn",
            "sign_no": 10,
            "longitude": "8:25:14",
            "house": 8,
            "nakshatra": "Uttara Ashada",
            "nakshatra_pada": 4,
            "nakshatra_no": 21,
            "karakamsha": "",
            "karakamsha_functionality": ""
        }
    ]
}

The response includes the sign, degree, nakshatra, and karakamsha significance for each planet in Jaimini astrology.


Example Integrations

Below are examples of how you might call this API using different programming languages and environments.


cURL

curl --location 'https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'full_name="Rahul kumar"' \
--form 'day="24"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'hour="14"' \
--form 'min="40"' \
--form 'sec="43"' \
--form 'gender="male"' \
--form 'place="New Delhi "' \
--form 'lat="28.7041"' \
--form 'lon="77.1025"' \
--form 'tzone="5.5"' \
--form 'lan="en"' \

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'full_name': 'Rahul kumar',
    'day': '24',
    'month': '05',
    'year': '2023',
    'hour': '14',
    'min': '40',
    'sec': '43',
    'gender': 'male',
    'place': 'New Delhi ',
    'lat': '28.7041',
    'lon': '77.1025',
    'tzone': '5.5',
    'lan': 'en',
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

JavaScript jQuery AJAX

var form = new FormData();
form.append("api_key", "{Your API Key}");
form.append("full_name", "Rahul kumar");
form.append("day", "24");
form.append("month", "05");
form.append("year", "2023");
form.append("hour", "14");
form.append("min", "40");
form.append("sec", "43");
form.append("gender", "male");
form.append("place", "New Delhi ");
form.append("lat", "28.7041");
form.append("lon", "77.1025");
form.append("tzone", "5.5");
form.append("lan", "en");

var settings = {
  "url": "https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer {Your Auth Token}"
  },
  "processData": false,
  "mimeType": "multipart/form-data",
  "contentType": false,
  "data": form
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Python

import requests

url = "https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions"

payload = {'api_key': '{Your API Key}',
'full_name': 'Rahul kumar',
'day': '24',
'month': '05',
'year': '2023',
'hour': '14',
'min': '40',
'sec': '43',
'gender': 'male',
'place': 'New Delhi ',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5',
'lan': 'en',}

headers = {
  'Authorization': 'Bearer {Your Auth Token}'
}

response = requests.request("POST", url, headers=headers)

print(response.text)
Example Code
curl -X POST "https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions" \
  -H "Authorization: Bearer {Your Auth Token}" \
  --form 'api_key="{Your API Key}"' \
  --form 'full_name="Rahul kumar"' \
  --form 'day="24"' \
  --form 'month="05"' \
  --form 'year="2023"' \
  --form 'hour="14"' \
  --form 'min="40"' \
  --form 'sec="43"' \
  --form 'gender="male"' \
  --form 'place="New Delhi "' \
  --form 'lat="28.7041"' \
  --form 'lon="77.1025"' \
  --form 'tzone="5.5"' \
  --form 'lan="en"'
const FormData = require('form-data');
const axios = require('axios');

const form = new FormData();
form.append('api_key', '{Your API Key}');
form.append('full_name', 'Rahul kumar');
form.append('day', '24');
form.append('month', '05');
form.append('year', '2023');
form.append('hour', '14');
form.append('min', '40');
form.append('sec', '43');
form.append('gender', 'male');
form.append('place', 'New Delhi ');
form.append('lat', '28.7041');
form.append('lon', '77.1025');
form.append('tzone', '5.5');
form.append('lan', 'en');

const response = await axios.post('https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions', form, {
  headers: {
    ...form.getHeaders(),
    'Authorization': 'Bearer {Your Auth Token}',
  }
});

console.log(response.data);
import requests

url = "https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions"
headers = {
    "Authorization": "Bearer {Your Auth Token}",
}
payload = {
    "api_key": "{Your API Key}",
    "full_name": "Rahul kumar",
    "day": "24",
    "month": "05",
    "year": "2023",
    "hour": "14",
    "min": "40",
    "sec": "43",
    "gender": "male",
    "place": "New Delhi ",
    "lat": "28.7041",
    "lon": "77.1025",
    "tzone": "5.5",
    "lan": "en",
}

response = requests.post(url, headers=headers, data=payload)

print(response.json())
const formData = new FormData();
formData.append('api_key', '{Your API Key}');
formData.append('full_name', 'Rahul kumar');
formData.append('day', '24');
formData.append('month', '05');
formData.append('year', '2023');
formData.append('hour', '14');
formData.append('min', '40');
formData.append('sec', '43');
formData.append('gender', 'male');
formData.append('place', 'New Delhi ');
formData.append('lat', '28.7041');
formData.append('lon', '77.1025');
formData.append('tzone', '5.5');
formData.append('lan', 'en');

const response = await fetch('https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions', {
  method: 'POST',
  headers: {
      'Authorization': "Bearer {Your Auth Token}",
    },
  body: formData,
});

const data = await response.json();
console.log(data);
<?php

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('POST', 'https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions', [
    'headers' => [
        'Authorization' => 'Bearer {Your Auth Token}',
    ],
    'multipart' => [
        ['name' => 'api_key', 'contents' => '{Your API Key}'],
        ['name' => 'full_name', 'contents' => 'Rahul kumar'],
        ['name' => 'day', 'contents' => '24'],
        ['name' => 'month', 'contents' => '05'],
        ['name' => 'year', 'contents' => '2023'],
        ['name' => 'hour', 'contents' => '14'],
        ['name' => 'min', 'contents' => '40'],
        ['name' => 'sec', 'contents' => '43'],
        ['name' => 'gender', 'contents' => 'male'],
        ['name' => 'place', 'contents' => 'New Delhi '],
        ['name' => 'lat', 'contents' => '28.7041'],
        ['name' => 'lon', 'contents' => '77.1025'],
        ['name' => 'tzone', 'contents' => '5.5'],
        ['name' => 'lan', 'contents' => 'en'],
    ],
]);

echo $response->getBody();
package main

import (
    "bytes"
    "fmt"
    "mime/multipart"
    "net/http"
    "io"
)

func main() {
    body := &bytes.Buffer{}
    writer := multipart.NewWriter(body)
    writer.WriteField("api_key", "{Your API Key}")
    writer.WriteField("full_name", "Rahul kumar")
    writer.WriteField("day", "24")
    writer.WriteField("month", "05")
    writer.WriteField("year", "2023")
    writer.WriteField("hour", "14")
    writer.WriteField("min", "40")
    writer.WriteField("sec", "43")
    writer.WriteField("gender", "male")
    writer.WriteField("place", "New Delhi ")
    writer.WriteField("lat", "28.7041")
    writer.WriteField("lon", "77.1025")
    writer.WriteField("tzone", "5.5")
    writer.WriteField("lan", "en")
    writer.Close()

    req, _ := http.NewRequest("POST", "https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions", body)
    req.Header.Set("Content-Type", writer.FormDataContentType())
    req.Header.Set("Authorization", "Bearer {Your Auth Token}")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body2, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body2))
}
import okhttp3.*;
import java.io.IOException;

public class Main {
    public static void main(String[] args) throws IOException {
        OkHttpClient client = new OkHttpClient();

        RequestBody body = new MultipartBody.Builder()
            .setType(MultipartBody.FORM)
            .addFormDataPart("api_key", "{Your API Key}")
            .addFormDataPart("full_name", "Rahul kumar")
            .addFormDataPart("day", "24")
            .addFormDataPart("month", "05")
            .addFormDataPart("year", "2023")
            .addFormDataPart("hour", "14")
            .addFormDataPart("min", "40")
            .addFormDataPart("sec", "43")
            .addFormDataPart("gender", "male")
            .addFormDataPart("place", "New Delhi ")
            .addFormDataPart("lat", "28.7041")
            .addFormDataPart("lon", "77.1025")
            .addFormDataPart("tzone", "5.5")
            .addFormDataPart("lan", "en")
            .build();

        Request request = new Request.Builder()
            .url("https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions")
            .post(body)
            .addHeader("Authorization", "Bearer {Your Auth Token}")
            .build();

        Response response = client.newCall(request).execute();
        System.out.println(response.body().string());
    }
}
import Foundation

let url = URL(string: "https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer {Your Auth Token}", forHTTPHeaderField: "Authorization")

let boundary = "Boundary-\(UUID().uuidString)"
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

var bodyData = Data()
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"api_key\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("{Your API Key}\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"full_name\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("Rahul kumar\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"day\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("24\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"month\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("05\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"year\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("2023\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"hour\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("14\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"min\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("40\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"sec\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("43\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"gender\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("male\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"place\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("New Delhi \r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"lat\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("28.7041\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"lon\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("77.1025\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"tzone\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("5.5\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"lan\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("en\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)--\r\n".data(using: .utf8)!)
request.httpBody = bodyData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()
import okhttp3.*

fun main() {
    val client = OkHttpClient()

    val body = MultipartBody.Builder()
        .setType(MultipartBody.FORM)
        .addFormDataPart("api_key", "{Your API Key}")
        .addFormDataPart("full_name", "Rahul kumar")
        .addFormDataPart("day", "24")
        .addFormDataPart("month", "05")
        .addFormDataPart("year", "2023")
        .addFormDataPart("hour", "14")
        .addFormDataPart("min", "40")
        .addFormDataPart("sec", "43")
        .addFormDataPart("gender", "male")
        .addFormDataPart("place", "New Delhi ")
        .addFormDataPart("lat", "28.7041")
        .addFormDataPart("lon", "77.1025")
        .addFormDataPart("tzone", "5.5")
        .addFormDataPart("lan", "en")
        .build()

    val request = Request.Builder()
        .url("https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions")
        .post(body!!)
        .addHeader("Authorization", "Bearer {Your Auth Token}")
        .build()

    client.newCall(request).execute().use { response ->
        println(response.body?.string())
    }
}
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program {
    static async Task Main() {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer {Your Auth Token}");

        var content = new MultipartFormDataContent();
        content.Add(new StringContent("{Your API Key}"), "api_key");
        content.Add(new StringContent("Rahul kumar"), "full_name");
        content.Add(new StringContent("24"), "day");
        content.Add(new StringContent("05"), "month");
        content.Add(new StringContent("2023"), "year");
        content.Add(new StringContent("14"), "hour");
        content.Add(new StringContent("40"), "min");
        content.Add(new StringContent("43"), "sec");
        content.Add(new StringContent("male"), "gender");
        content.Add(new StringContent("New Delhi "), "place");
        content.Add(new StringContent("28.7041"), "lat");
        content.Add(new StringContent("77.1025"), "lon");
        content.Add(new StringContent("5.5"), "tzone");
        content.Add(new StringContent("en"), "lan");

        var response = await client.PostAsync("https://astroapi-3.divineapi.com/indian-api/v2/jaimini-astrology/planetary-positions", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}