Sub Planet Chart
Explore the dynamic celestial interplay with the Sub Planet Chart API, which provides precise insights into the positions of sub-planets (Upa Grahas) that influence astrological interpretations within Indian Vedic Astrology. This API returns detailed positional data along with an SVG-based visual Kundli representation.
Step-by-Step Sub Planet Chart API Postman Testing Integration
Supported Language Codes
Support Article URL: Translating Indian Vedic APIs into Different Languages
| Code | Language |
|---|---|
| en | English |
| hi | Hindi |
| bn | Bengali |
| ma | Marathi |
| tm | Tamil |
| tl | Telugu |
| ml | Malayalam |
| kn | Kannada |
Guide:
These languages are supported by this API. You can specify the language by passing the “lan” parameter in the request body with the respective language code. The default language is English (en).
API Endpoint
POST https://astroapi-3.divineapi.com/indian-api/v1/sub-planet-chart
This endpoint returns a Sub Planet Chart that includes SVG visualization, base64-encoded image, and data for each sub-planet.
Headers
| Name | Type | Description |
|---|---|---|
| Authorization | String | Your API Access Token. Example: Bearer {token} |
Request Body
| Name | Type | Description |
|---|---|---|
| api_key | String | Your API key |
| full_name | String | Full name, e.g., Rahul Kumar |
| day | Integer | Date of birth, e.g., 24 |
| month | Integer | Month of birth, e.g., 05 |
| year | Integer | Year of birth, e.g., 2023 |
| hour | Integer | Hour of birth, e.g., 14 |
| min | Integer | Minute of birth, e.g., 40 |
| sec | Integer | Second of birth, e.g., 43 |
| gender | String | Gender, e.g., male |
| place | String | Place of birth, e.g., New Delhi |
| lat | Float | Latitude, e.g., 28.7041 |
| lon | Float | Longitude, e.g., 77.1025 |
| tzone | Float | Timezone, e.g., 5.5 (Timezone Reference Guide) |
| lan | String | Language code as per supported table above. Default is ‘en’. |
| planet_color | String | Color for planets, e.g., "#333333" or "black" |
| sign_color | String | Color for zodiac signs, e.g., "#333333" or "black" |
| line_color | String | Color for chart lines, e.g., "#333333" or "black" |
| chart_color | String | Background color of the chart, e.g., "#FFFFFF" or "black" |
| chart_type | String | Chart type, e.g., north or south |
200: OK Sub Planets Positions fetched successfully
{
"success": 1,
"data": {
"svg": "<svg height=\"360\" width=\"360\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n \n \n <rect x=\"0\" y=\"0\" width=\"360\" height=\"360\" fill=\"transparent\" stroke=\"#000\" stroke-width=\"4\"></rect>\n\t<line x1=\"0\" y1=\"0\" x2=\"360\" y2=\"360\" stroke=\"#000\" stroke-width=\"2\"></line>\n\t<line x1=\"0\" y1=\"360\" x2=\"360\" y2=\"0\" stroke=\"#000\" stroke-width=\"2\"></line>\n\t<line x1=\"0\" y1=\"180\" x2=\"180\" y2=\"0\" stroke=\"#000\" stroke-width=\"2\"></line>\n\t<line x1=\"180\" y1=\"0\" x2=\"360\" y2=\"180\" stroke=\"#000\" stroke-width=\"2\"></line>\n\t<line x1=\"360\" y1=\"180\" x2=\"180\" y2=\"360\" stroke=\"#000\" stroke-width=\"2\"></line>\n\t<line x1=\"0\" y1=\"180\" x2=\"180\" y2=\"360\" stroke=\"#000\" stroke-width=\"2\"></line>\n\n <text x=\"177\" y=\"171\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">6</text>\n <text x=\"87\" y=\"81\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">7</text>\n <text x=\"72\" y=\"93\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">8</text>\n <text x=\"162\" y=\"185\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">9</text>\n <text x=\"72\" y=\"273\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">10</text>\n <text x=\"87\" y=\"288\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">11</text>\n <text x=\"175\" y=\"198\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">12</text>\n <text x=\"266\" y=\"288\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">1</text>\n <text x=\"282\" y=\"273\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">2</text>\n <text x=\"195\" y=\"185\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">3</text>\n <text x=\"279\" y=\"93\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">4</text>\n <text x=\"264\" y=\"81\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">5</text>\n \n <text x=\"165\" y=\"72\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">Dh</text>\n <text x=\"185\" y=\"72\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">Ka</text>\n \n \n <text x=\"70\" y=\"32\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">Vy</text>\n <text x=\"90\" y=\"32\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">Mr</text>\n \n \n \n \n \n \n \n \n \n \n <text x=\"164\" y=\"272\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">In</text>\n \n \n <text x=\"244\" y=\"330\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">Pa</text>\n <text x=\"264\" y=\"330\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">Up</text>\n \n \n \n \n <text x=\"270\" y=\"170\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">Ya</text>\n <text x=\"270\" y=\"185\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">Ar</text>\n \n \n \n \n <text x=\"254\" y=\"36\" style=\"fill:#000; font-size:12px; stroke:#000;\" font=\"Tahoma\" font-family=\"sans-serif\">Gu</text>\n \n</svg>\n",
"base64_image": "data:image/svg+xml;base64,PHN2ZyBoZWlnaHQ9IjM2MCIgd2lkdGg9IjM2MCIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB4bWxuczp4bGluaz0iaHR0cDovL3d3dy53My5vcmcvMTk5OS94bGluayI+CiAgICAKICAgIAogICAgPHJlY3QgeD0iMCIgeT0iMCIgd2lkdGg9IjM2MCIgaGVpZ2h0PSIzNjAiIGZpbGw9InRyYW5zcGFyZW50IiBzdHJva2U9IiMwMDAiIHN0cm9rZS13aWR0aD0iNCI+PC9yZWN0PgoJPGxpbmUgeDE9IjAiIHkxPSIwIiB4Mj0iMzYwIiB5Mj0iMzYwIiBzdHJva2U9IiMwMDAiIHN0cm9rZS13aWR0aD0iMiI+PC9saW5lPgoJPGxpbmUgeDE9IjAiIHkxPSIzNjAiIHgyPSIzNjAiIHkyPSIwIiBzdHJva2U9IiMwMDAiIHN0cm9rZS13aWR0aD0iMiI+PC9saW5lPgoJPGxpbmUgeDE9IjAiIHkxPSIxODAiIHgyPSIxODAiIHkyPSIwIiBzdHJva2U9IiMwMDAiIHN0cm9rZS13aWR0aD0iMiI+PC9saW5lPgoJPGxpbmUgeDE9IjE4MCIgeTE9IjAiIHgyPSIzNjAiIHkyPSIxODAiIHN0cm9rZT0iIzAwMCIgc3Ryb2tlLXdpZHRoPSIyIj48L2xpbmU+Cgk8bGluZSB4MT0iMzYwIiB5MT0iMTgwIiB4Mj0iMTgwIiB5Mj0iMzYwIiBzdHJva2U9IiMwMDAiIHN0cm9rZS13aWR0aD0iMiI+PC9saW5lPgoJPGxpbmUgeDE9IjAiIHkxPSIxODAiIHgyPSIxODAiIHkyPSIzNjAiIHN0cm9rZT0iIzAwMCIgc3Ryb2tlLXdpZHRoPSIyIj48L2xpbmU+CgogICAgPHRleHQgeD0iMTc3IiB5PSIxNzEiIHN0eWxlPSJmaWxsOiMwMDA7IGZvbnQtc2l6ZToxMnB4OyBzdHJva2U6IzAwMDsiIGZvbnQ9IlRhaG9tYSIgZm9udC1mYW1pbHk9InNhbnMtc2VyaWYiPjY8L3RleHQ+CiAgICA8dGV4dCB4PSI4NyIgeT0iODEiIHN0eWxlPSJmaWxsOiMwMDA7IGZvbnQtc2l6ZToxMnB4OyBzdHJva2U6IzAwMDsiIGZvbnQ9IlRhaG9tYSIgZm9udC1mYW1pbHk9InNhbnMtc2VyaWYiPjc8L3RleHQ+CiAgICA8dGV4dCB4PSI3MiIgeT0iOTMiIHN0eWxlPSJmaWxsOiMwMDA7IGZvbnQtc2l6ZToxMnB4OyBzdHJva2U6IzAwMDsiIGZvbnQ9IlRhaG9tYSIgZm9udC1mYW1pbHk9InNhbnMtc2VyaWYiPjg8L3RleHQ+CiAgICA8dGV4dCB4PSIxNjIiIHk9IjE4NSIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IHN0cm9rZTojMDAwOyIgZm9udD0iVGFob21hIiBmb250LWZhbWlseT0ic2Fucy1zZXJpZiI+OTwvdGV4dD4KICAgIDx0ZXh0IHg9IjcyIiB5PSIyNzMiIHN0eWxlPSJmaWxsOiMwMDA7IGZvbnQtc2l6ZToxMnB4OyBzdHJva2U6IzAwMDsiIGZvbnQ9IlRhaG9tYSIgZm9udC1mYW1pbHk9InNhbnMtc2VyaWYiPjEwPC90ZXh0PgogICAgPHRleHQgeD0iODciIHk9IjI4OCIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IHN0cm9rZTojMDAwOyIgZm9udD0iVGFob21hIiBmb250LWZhbWlseT0ic2Fucy1zZXJpZiI+MTE8L3RleHQ+CiAgICA8dGV4dCB4PSIxNzUiIHk9IjE5OCIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IHN0cm9rZTojMDAwOyIgZm9udD0iVGFob21hIiBmb250LWZhbWlseT0ic2Fucy1zZXJpZiI+MTI8L3RleHQ+CiAgICA8dGV4dCB4PSIyNjYiIHk9IjI4OCIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IHN0cm9rZTojMDAwOyIgZm9udD0iVGFob21hIiBmb250LWZhbWlseT0ic2Fucy1zZXJpZiI+MTwvdGV4dD4KICAgIDx0ZXh0IHg9IjI4MiIgeT0iMjczIiBzdHlsZT0iZmlsbDojMDAwOyBmb250LXNpemU6MTJweDsgc3Ryb2tlOiMwMDA7IiBmb250PSJUYWhvbWEiIGZvbnQtZmFtaWx5PSJzYW5zLXNlcmlmIj4yPC90ZXh0PgogICAgPHRleHQgeD0iMTk1IiB5PSIxODUiIHN0eWxlPSJmaWxsOiMwMDA7IGZvbnQtc2l6ZToxMnB4OyBzdHJva2U6IzAwMDsiIGZvbnQ9IlRhaG9tYSIgZm9udC1mYW1pbHk9InNhbnMtc2VyaWYiPjM8L3RleHQ+CiAgICA8dGV4dCB4PSIyNzkiIHk9IjkzIiBzdHlsZT0iZmlsbDojMDAwOyBmb250LXNpemU6MTJweDsgc3Ryb2tlOiMwMDA7IiBmb250PSJUYWhvbWEiIGZvbnQtZmFtaWx5PSJzYW5zLXNlcmlmIj40PC90ZXh0PgogICAgPHRleHQgeD0iMjY0IiB5PSI4MSIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IHN0cm9rZTojMDAwOyIgZm9udD0iVGFob21hIiBmb250LWZhbWlseT0ic2Fucy1zZXJpZiI+NTwvdGV4dD4KICAgIAogICAgICAgICAgICAgICAgPHRleHQgeD0iMTY1IiB5PSI3MiIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IHN0cm9rZTojMDAwOyIgZm9udD0iVGFob21hIiBmb250LWZhbWlseT0ic2Fucy1zZXJpZiI+RGg8L3RleHQ+CiAgICAgICAgICAgICAgICAgICAgPHRleHQgeD0iMTg1IiB5PSI3MiIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IHN0cm9rZTojMDAwOyIgZm9udD0iVGFob21hIiBmb250LWZhbWlseT0ic2Fucy1zZXJpZiI+S2E8L3RleHQ+CiAgICAgICAgICAgIAogICAgCiAgICAgICAgICAgICAgICA8dGV4dCB4PSI3MCIgeT0iMzIiIHN0eWxlPSJmaWxsOiMwMDA7IGZvbnQtc2l6ZToxMnB4OyBzdHJva2U6IzAwMDsiIGZvbnQ9IlRhaG9tYSIgZm9udC1mYW1pbHk9InNhbnMtc2VyaWYiPlZ5PC90ZXh0PgogICAgICAgICAgICAgICAgICAgIDx0ZXh0IHg9IjkwIiB5PSIzMiIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IHN0cm9rZTojMDAwOyIgZm9udD0iVGFob21hIiBmb250LWZhbWlseT0ic2Fucy1zZXJpZiI+TXI8L3RleHQ+CiAgICAgICAgICAgIAogICAgCiAgICAgICAgCiAgICAKICAgICAgICAKICAgIAogICAgICAgIAogICAgCiAgICAgICAgCiAgICAKICAgICAgICAgICAgICAgIDx0ZXh0IHg9IjE2NCIgeT0iMjcyIiBzdHlsZT0iZmlsbDojMDAwOyBmb250LXNpemU6MTJweDsgc3Ryb2tlOiMwMDA7IiBmb250PSJUYWhvbWEiIGZvbnQtZmFtaWx5PSJzYW5zLXNlcmlmIj5JbjwvdGV4dD4KICAgICAgICAgICAgCiAgICAKICAgICAgICAgICAgICAgIDx0ZXh0IHg9IjI0NCIgeT0iMzMwIiBzdHlsZT0iZmlsbDojMDAwOyBmb250LXNpemU6MTJweDsgc3Ryb2tlOiMwMDA7IiBmb250PSJUYWhvbWEiIGZvbnQtZmFtaWx5PSJzYW5zLXNlcmlmIj5QYTwvdGV4dD4KICAgICAgICAgICAgICAgICAgICA8dGV4dCB4PSIyNjQiIHk9IjMzMCIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IHN0cm9rZTojMDAwOyIgZm9udD0iVGFob21hIiBmb250LWZhbWlseT0ic2Fucy1zZXJpZiI+VXA8L3RleHQ+CiAgICAgICAgICAgIAogICAgCiAgICAgICAgCiAgICAKICAgICAgICAgICAgICAgIDx0ZXh0IHg9IjI3MCIgeT0iMTcwIiBzdHlsZT0iZmlsbDojMDAwOyBmb250LXNpemU6MTJweDsgc3Ryb2tlOiMwMDA7IiBmb250PSJUYWhvbWEiIGZvbnQtZmFtaWx5PSJzYW5zLXNlcmlmIj5ZYTwvdGV4dD4KICAgICAgICAgICAgICAgICAgICA8dGV4dCB4PSIyNzAiIHk9IjE4NSIgc3R5bGU9ImZpbGw6IzAwMDsgZm9udC1zaXplOjEycHg7IHN0cm9rZTojMDAwOyIgZm9udD0iVGFob21hIiBmb250LWZhbWlseT0ic2Fucy1zZXJpZiI+QXI8L3RleHQ+CiAgICAgICAgICAgIAogICAgCiAgICAgICAgCiAgICAKICAgICAgICAgICAgICAgIDx0ZXh0IHg9IjI1NCIgeT0iMzYiIHN0eWxlPSJmaWxsOiMwMDA7IGZvbnQtc2l6ZToxMnB4OyBzdHJva2U6IzAwMDsiIGZvbnQ9IlRhaG9tYSIgZm9udC1mYW1pbHk9InNhbnMtc2VyaWYiPkd1PC90ZXh0PgogICAgICAgICAgICAKPC9zdmc+Cg==",
"data": {
"1": {
"sign_no": 6,
"planet": [
{
"name": "Dhuma",
"symbol": "Dh"
},
{
"name": "Kaala",
"symbol": "Ka"
}
]
},
"2": {
"sign_no": 7,
"planet": [
{
"name": "Vyatripata",
"symbol": "Vy"
},
{
"name": "Mrityu",
"symbol": "Mr"
}
]
},
"3": {
"sign_no": 8,
"planet": []
},
"4": {
"sign_no": 9,
"planet": []
},
"5": {
"sign_no": 10,
"planet": []
},
"6": {
"sign_no": 11,
"planet": []
},
"7": {
"sign_no": 12,
"planet": [
{
"name": "Indrachapa",
"symbol": "In"
}
]
},
"8": {
"sign_no": 1,
"planet": [
{
"name": "Parivesh",
"symbol": "Pa"
},
{
"name": "Upaketu",
"symbol": "Up"
}
]
},
"9": {
"sign_no": 2,
"planet": []
},
"10": {
"sign_no": 3,
"planet": [
{
"name": "Yamaghantaka",
"symbol": "Ya"
},
{
"name": "Ardhaprahara",
"symbol": "Ar"
}
]
},
"11": {
"sign_no": 4,
"planet": []
},
"12": {
"sign_no": 5,
"planet": [
{
"name": "Gulika",
"symbol": "Gu"
}
]
}
}
}
}
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/v1/sub-planet-chart' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'full_name="Test"' \
--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/v1/sub-planet-chart',
'headers': {
'Authorization': 'Bearer {Your Auth Token}'
},
formData: {
'api_key': '{Your API Key}',
'full_name': 'Test',
'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", "Test");
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/v1/sub-planet-chart",
"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/v1/sub-planet-chart
"
payload = {'api_key': '{Your API Key}',
'full_name': 'Test',
'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, data=payload)
print(response.text)
Summary
The Sub Planet Chart API provides detailed insights into the positioning of sub-planets such as Dhuma, Vyatripata, Mrityu, Kaala, Gulika, Indrachapa, Parivesh, Upaketu, Yamaghantaka, and Ardhaprahara.
This API generates a graphical Sub Planet Chart (SVG) and raw positional data, enabling seamless integration into astrology software, web dashboards, and analytical platforms that visualize planetary influence.