Planetary Positions
Explore the current celestial layout with Synastry Planetary Positions, understanding the astrological influence of each planet.
Step by Step Planetary Positions API Postman Testing Integration
View Full Guide on Support Portal
Use Translator for Other Languages
Support Article URL: https://support.divineapi.com/general-api-support/translating-a-natal-apis-into-a-different-language
| Code | Language |
|---|---|
| en | English |
| hi | Hindi |
| pt | Portuguese |
| fr | French |
| de | German |
| ja | Japanese |
| tr | Turkish |
| ru | Russian |
| it | Italian |
| es | Spanish |
| nl | Dutch |
| pl | Polish |
Guide: These languages are supported by this API. You can use them by passing "lan" in the body with the value of the language.
API Endpoint
POST https://astroapi-4.divineapi.com/western-api/v1/synastry/planetary-positions
Returns: Planetary Positions in response.
Headers
| Name | Type | Description |
|---|---|---|
| Authorization* | String | Your API Access Token. Example: Bearer {token} |
Request Body
| Name | Type | Description |
|---|---|---|
| api_key* | String | Your API key |
| p1_full_name* | String | P1's Full Name, e.g., Rahul Kumar |
| p1_day* | Integer | P1's date of birth, e.g., 24 |
| p1_month* | Integer | P1's month of birth, e.g., 05 |
| p1_year* | Integer | P1's year of birth, e.g., 1998 |
| p1_hour* | Integer | P1's hour, e.g., 14 |
| p1_min* | Integer | P1's minute, e.g., 40 |
| p1_sec* | Integer | P1's second, e.g., 43 |
| p1_gender* | String | P1's gender, e.g., male |
| p1_place* | String | P1's birthplace, e.g., New Delhi |
| p1_lat* | Float | P1's latitude, e.g., 28.7041 |
| p1_lon* | Float | P1's longitude, e.g., 77.1025 |
| p1_tzone* | Float | P1's timezone, e.g., 5.5 Timezone List |
| p2_full_name* | String | P2's Full Name, e.g., Simran Kumari |
| p2_day* | Integer | P2's date of birth, e.g., 24 |
| p2_month* | Integer | P2's month of birth, e.g., 05 |
| p2_year* | Integer | P2's year of birth, e.g., 1998 |
| p2_hour* | Integer | P2's hour, e.g., 14 |
| p2_min* | Integer | P2's minute, e.g., 40 |
| p2_sec* | Integer | P2's second, e.g., 43 |
| p2_gender* | String | P2's gender, e.g., female |
| p2_place* | String | P2's birthplace, e.g., New Delhi |
| p2_lat* | Float | P2's latitude, e.g., 28.7041 |
| p2_lon* | Float | P2's longitude, e.g., 77.1025 |
| p2_tzone* | Float | P2's timezone, e.g., 5.5 Timezone List |
| lan | String | Language code, default: en |
| house_system | String | House system code, default: P (Placidus) |
| node_type | String | meannode or truenode (default: meannode) |
200: OK Planetary Positions fetched successfully
{
"success": 1,
"data": {
"p1_data": [
{
"name": "Ascendant",
"full_degree": "185.7672390",
"sign": "Libra",
"sign_no": 7,
"longitude": "5:46:2",
"speed": "317.7048528",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 1,
"element": "Air",
"modality": "Cardinal"
},
{
"name": "Sun",
"full_degree": "63.0091751",
"sign": "Gemini",
"sign_no": 3,
"longitude": "3:0:33",
"speed": "0.9613438",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 8,
"element": "Air",
"modality": "Mutable"
},
{
"name": "Moon",
"full_degree": "43.0997128",
"sign": "Taurus",
"sign_no": 2,
"longitude": "13:5:59",
"speed": "14.9291250",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 8,
"element": "Earth",
"modality": "Fixed"
},
{
"name": "Mars",
"full_degree": "60.1624736",
"sign": "Gemini",
"sign_no": 3,
"longitude": "0:9:45",
"speed": "0.7120409",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 8,
"element": "Air",
"modality": "Mutable"
},
{
"name": "Mercury",
"full_degree": "44.8177723",
"sign": "Taurus",
"sign_no": 2,
"longitude": "14:49:4",
"speed": "1.7659440",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 8,
"element": "Earth",
"modality": "Fixed"
},
{
"name": "Venus",
"full_degree": "23.5057226",
"sign": "Aries",
"sign_no": 1,
"longitude": "23:30:21",
"speed": "1.1570195",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 7,
"element": "Fire",
"modality": "Cardinal"
},
{
"name": "Jupiter",
"full_degree": "353.5970305",
"sign": "Pisces",
"sign_no": 12,
"longitude": "23:35:49",
"speed": "0.1518252",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 6,
"element": "Water",
"modality": "Mutable"
},
{
"name": "Saturn",
"full_degree": "28.3255821",
"sign": "Aries",
"sign_no": 1,
"longitude": "28:19:32",
"speed": "0.1119515",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 7,
"element": "Fire",
"modality": "Cardinal"
},
{
"name": "North node",
"full_degree": "156.1323021",
"sign": "Virgo",
"sign_no": 6,
"longitude": "6:7:56",
"speed": "-0.0529512",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 11,
"element": "Earth",
"modality": "Mutable"
},
{
"name": "South node",
"full_degree": 336.1323021,
"sign": "Pisces",
"sign_no": 12,
"longitude": "6:7:56",
"speed": "-0.0529512",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 5,
"element": "Water",
"modality": "Mutable"
},
{
"name": "Uranus",
"full_degree": "312.7243558",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "12:43:28",
"speed": "-0.0055327",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 5,
"element": "Air",
"modality": "Fixed"
},
{
"name": "Neptune",
"full_degree": "302.0576072",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "2:3:27",
"speed": "-0.0104110",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 4,
"element": "Air",
"modality": "Fixed"
},
{
"name": "Pluto",
"full_degree": "246.7995404",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "6:47:58",
"speed": "-0.0272761",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 3,
"element": "Fire",
"modality": "Mutable"
},
{
"name": "MC",
"full_degree": "96.0131067",
"sign": "Cancer",
"sign_no": 4,
"longitude": "6:0:47",
"speed": "331.8865231",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 9,
"element": "Water",
"modality": "Cardinal"
},
{
"name": "Chiron",
"full_degree": "224.2841493",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "14:17:3",
"speed": "-0.0688174",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 2,
"element": "Water",
"modality": "Fixed"
},
{
"name": "Part of fortune",
"full_degree": 165.8577767,
"sign": "Virgo",
"sign_no": 6,
"longitude": "15:51:27",
"speed": "--",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 12,
"element": "Earth",
"modality": "Mutable"
}
],
"p2_data": [
{
"name": "Ascendant",
"full_degree": "185.7672390",
"sign": "Libra",
"sign_no": 7,
"longitude": "5:46:2",
"speed": "317.7048528",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 1,
"element": "Air",
"modality": "Cardinal"
},
{
"name": "Sun",
"full_degree": "63.0091751",
"sign": "Gemini",
"sign_no": 3,
"longitude": "3:0:33",
"speed": "0.9613438",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 8,
"element": "Air",
"modality": "Mutable"
},
{
"name": "Moon",
"full_degree": "43.0997128",
"sign": "Taurus",
"sign_no": 2,
"longitude": "13:5:59",
"speed": "14.9291250",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 8,
"element": "Earth",
"modality": "Fixed"
},
{
"name": "Mars",
"full_degree": "60.1624736",
"sign": "Gemini",
"sign_no": 3,
"longitude": "0:9:45",
"speed": "0.7120409",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 8,
"element": "Air",
"modality": "Mutable"
},
{
"name": "Mercury",
"full_degree": "44.8177723",
"sign": "Taurus",
"sign_no": 2,
"longitude": "14:49:4",
"speed": "1.7659440",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 8,
"element": "Earth",
"modality": "Fixed"
},
{
"name": "Venus",
"full_degree": "23.5057226",
"sign": "Aries",
"sign_no": 1,
"longitude": "23:30:21",
"speed": "1.1570195",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 7,
"element": "Fire",
"modality": "Cardinal"
},
{
"name": "Jupiter",
"full_degree": "353.5970305",
"sign": "Pisces",
"sign_no": 12,
"longitude": "23:35:49",
"speed": "0.1518252",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 6,
"element": "Water",
"modality": "Mutable"
},
{
"name": "Saturn",
"full_degree": "28.3255821",
"sign": "Aries",
"sign_no": 1,
"longitude": "28:19:32",
"speed": "0.1119515",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 7,
"element": "Fire",
"modality": "Cardinal"
},
{
"name": "North node",
"full_degree": "156.1323021",
"sign": "Virgo",
"sign_no": 6,
"longitude": "6:7:56",
"speed": "-0.0529512",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 11,
"element": "Earth",
"modality": "Mutable"
},
{
"name": "South node",
"full_degree": 336.1323021,
"sign": "Pisces",
"sign_no": 12,
"longitude": "6:7:56",
"speed": "-0.0529512",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 5,
"element": "Water",
"modality": "Mutable"
},
{
"name": "Uranus",
"full_degree": "312.7243558",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "12:43:28",
"speed": "-0.0055327",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 5,
"element": "Air",
"modality": "Fixed"
},
{
"name": "Neptune",
"full_degree": "302.0576072",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "2:3:27",
"speed": "-0.0104110",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 4,
"element": "Air",
"modality": "Fixed"
},
{
"name": "Pluto",
"full_degree": "246.7995404",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "6:47:58",
"speed": "-0.0272761",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 3,
"element": "Fire",
"modality": "Mutable"
},
{
"name": "MC",
"full_degree": "96.0131067",
"sign": "Cancer",
"sign_no": 4,
"longitude": "6:0:47",
"speed": "331.8865231",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 9,
"element": "Water",
"modality": "Cardinal"
},
{
"name": "Chiron",
"full_degree": "224.2841493",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "14:17:3",
"speed": "-0.0688174",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 2,
"element": "Water",
"modality": "Fixed"
},
{
"name": "Part of fortune",
"full_degree": 165.8577767,
"sign": "Virgo",
"sign_no": 6,
"longitude": "15:51:27",
"speed": "--",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 12,
"element": "Earth",
"modality": "Mutable"
}
],
"synastry": {
"p1": [
{
"planet": "Ascendant",
"sign": "Libra",
"house": 1
},
{
"planet": "Sun",
"sign": "Gemini",
"house": 8
},
{
"planet": "Moon",
"sign": "Taurus",
"house": 8
},
{
"planet": "Mars",
"sign": "Gemini",
"house": 8
},
{
"planet": "Mercury",
"sign": "Taurus",
"house": 8
},
{
"planet": "Venus",
"sign": "Aries",
"house": 7
},
{
"planet": "Jupiter",
"sign": "Pisces",
"house": 6
},
{
"planet": "Saturn",
"sign": "Aries",
"house": 7
},
{
"planet": "North node",
"sign": "Virgo",
"house": 11
},
{
"planet": "South node",
"sign": "Pisces",
"house": 5
},
{
"planet": "Uranus",
"sign": "Aquarius",
"house": 5
},
{
"planet": "Neptune",
"sign": "Aquarius",
"house": 4
},
{
"planet": "Pluto",
"sign": "Sagittarius",
"house": 3
},
{
"planet": "Chiron",
"sign": "Scorpio",
"house": 2
},
{
"planet": "MC",
"sign": "Cancer",
"house": 9
},
{
"planet": "Part of fortune",
"sign": "Virgo",
"house": 12
}
],
"p2": [
{
"planet": "Ascendant",
"sign": "Libra",
"house": 1
},
{
"planet": "Sun",
"sign": "Gemini",
"house": 8
},
{
"planet": "Moon",
"sign": "Taurus",
"house": 8
},
{
"planet": "Mars",
"sign": "Gemini",
"house": 8
},
{
"planet": "Mercury",
"sign": "Taurus",
"house": 8
},
{
"planet": "Venus",
"sign": "Aries",
"house": 7
},
{
"planet": "Jupiter",
"sign": "Pisces",
"house": 6
},
{
"planet": "Saturn",
"sign": "Aries",
"house": 7
},
{
"planet": "North node",
"sign": "Virgo",
"house": 11
},
{
"planet": "South node",
"sign": "Pisces",
"house": 5
},
{
"planet": "Uranus",
"sign": "Aquarius",
"house": 5
},
{
"planet": "Neptune",
"sign": "Aquarius",
"house": 4
},
{
"planet": "Pluto",
"sign": "Sagittarius",
"house": 3
},
{
"planet": "Chiron",
"sign": "Scorpio",
"house": 2
},
{
"planet": "MC",
"sign": "Cancer",
"house": 9
},
{
"planet": "Part of fortune",
"sign": "Virgo",
"house": 12
}
]
}
}
}Example Code Implementations
Below are example implementations in various programming environments.
cURL
curl --location 'https://astroapi-4.divineapi.com/western-api/v1/synastry/planetary-positions' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'p1_full_name="Rahul Kumar"' \
--form 'p1_day="24"' \
--form 'p1_month="05"' \
--form 'p1_year="1998"' \
--form 'p1_hour="14"' \
--form 'p1_min="40"' \
--form 'p1_sec="43"' \
--form 'p1_gender="male"' \
--form 'p1_place="New Delhi"' \
--form 'p1_lat="28.7041"' \
--form 'p1_lon="77.1025"' \
--form 'p1_tzone="5.5"' \
--form 'p2_full_name="Simran Kumari"' \
--form 'p2_day="24"' \
--form 'p2_month="05"' \
--form 'p2_year="1998"' \
--form 'p2_hour="14"' \
--form 'p2_min="40"' \
--form 'p2_sec="43"' \
--form 'p2_gender="female"' \
--form 'p2_place="New Delhi"' \
--form 'p2_lat="28.7041"' \
--form 'p2_lon="77.1025"' \
--form 'p2_tzone="5.5"' \
--form 'lan="en"'
NodeJS
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://astroapi-4.divineapi.com/western-api/v1/synastry/planetary-positions',
'headers': {
'Authorization': 'Bearer {Your Auth Token}'
},
formData: {
'api_key': '{Your API Key}',
'p1_full_name': 'Rahul Kumar',
'p1_day': '24',
'p1_month': '05',
'p1_year': '1998',
'p1_hour': '14',
'p1_min': '40',
'p1_sec': '43',
'p1_gender': 'male',
'p1_place': 'New Delhi',
'p1_lat': '28.7041',
'p1_lon': '77.1025',
'p1_tzone': '5.5',
'p2_full_name': 'Simran Kumari',
'p2_day': '24',
'p2_month': '05',
'p2_year': '1998',
'p2_hour': '14',
'p2_min': '40',
'p2_sec': '43',
'p2_gender': 'female',
'p2_place': 'New Delhi',
'p2_lat': '28.7041',
'p2_lon': '77.1025',
'p2_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("p1_full_name", "Rahul Kumar");
form.append("p1_day", "24");
form.append("p1_month", "05");
form.append("p1_year", "1998");
form.append("p1_hour", "14");
form.append("p1_min", "40");
form.append("p1_sec", "43");
form.append("p1_gender", "male");
form.append("p1_place", "New Delhi");
form.append("p1_lat", "28.7041");
form.append("p1_lon", "77.1025");
form.append("p1_tzone", "5.5");
form.append("p2_full_name", "Simran Kumari");
form.append("p2_day", "24");
form.append("p2_month", "05");
form.append("p2_year", "1998");
form.append("p2_hour", "14");
form.append("p2_min", "40");
form.append("p2_sec", "43");
form.append("p2_gender", "female");
form.append("p2_place", "New Delhi");
form.append("p2_lat", "28.7041");
form.append("p2_lon", "77.1025");
form.append("p2_tzone", "5.5");
form.append("lan", "en");
var settings = {
"url": "https://astroapi-4.divineapi.com/western-api/v1/synastry/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-4.divineapi.com/western-api/v1/synastry/planetary-positions"
payload = {'api_key': '{Your API Key}',
'p1_full_name': 'Rahul Kumar',
'p1_day': '24',
'p1_month': '05',
'p1_year': '1998',
'p1_hour': '14',
'p1_min': '40',
'p1_sec': '43',
'p1_gender': 'male',
'p1_place': 'New Delhi',
'p1_lat': '28.7041',
'p1_lon': '77.1025',
'p1_tzone': '5.5',
'p2_full_name': 'Simran Kumari',
'p2_day': '24',
'p2_month': '05',
'p2_year': '1998',
'p2_hour': '14',
'p2_min': '40',
'p2_sec': '43',
'p2_gender': 'female',
'p2_place': 'New Delhi',
'p2_lat': '28.7041',
'p2_lon': '77.1025',
'p2_tzone': '5.5',
'lan': 'en'}
headers = {
'Authorization': 'Bearer {Your Auth Token}'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
Implementation Tips
For accurate results, ensure both profiles use consistent timezones (p1_tzone, p2_tzone) and precise coordinates.
Sanitize inputs and validate required fields before calling the API to avoid 4xx errors.
Store the response as-is to preserve house/sign metadata for subsequent synastry overlays, charts, or reports.