Divine API
Copy page
Copy page as Markdown for LLMs
Aspect Table
Explore Synastry API's Aspect Table feature for nuanced relationship insights, detailing precise planetary aspects and angles to illuminate compatibility through in-depth astrological analysis.
Step by Step Aspect Table 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.
House System Codes
House System Codes Support Article URL: https://support.divineapi.com/western-astrology-apis/how-to-change-the-house-system-code-in-natal-astrology
| Code | System/Notes |
|---|---|
| P | Placidus |
| K | Koch |
| R | Regiomontanus |
| C | Campanus |
| A | Equal |
| W | Equal, whole sign |
| N | Whole sign, Aries = 1st house |
| X | Axial rotation system / Meridian houses |
| T | Polich/Page ("topocentric") |
| M | Morinus |
| O | Porphyry |
| B | Alcabitius |
| D | Equal / MC |
| E | Equal = A |
| F | Carter poli-equatorial |
| G | 36 Gauquelin sectors |
| H | Horizon / azimuth |
| I | Sunshine |
| i | Sunshine alternative |
| L | Pullen (S-delta) |
| Q | Pullen (S-ratio) |
| S | Sripati |
| U | Krusinski-Pisa-Goelzer |
| V | Equal Vehlow |
| Y | APC houses |
Note: The default house system used is P — Placidus.
API Endpoint
POST https://astroapi-4.divineapi.com/western-api/v1/synastry/aspect
Returns: Aspect Table 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, ex: Rahul Kumar |
| p1_day* | Integer | P1's date of birth, eg: 24 |
| p1_month* | Integer | P1's month of birth, eg: 05 |
| p1_year* | Integer | P1's year of birth, eg: 1998 |
| p1_hour* | Integer | P1's hour, eg: 14 |
| p1_min* | Integer | P1's minute, eg: 40 |
| p1_sec* | Integer | P1's second, eg: 43 |
| p1_gender* | String | P1's gender, ex: male |
| p1_place* | String | P1's birth place, ex: New Delhi |
| p1_lat* | Float | P1's latitude, eg: 28.7041 |
| p1_lon* | Float | P1's longitude, eg: 77.1025 |
| p1_tzone* | Float | P1's timezone, eg: 5.5 Timezone List |
| p2_full_name* | String | P2's Full Name, ex: Simran Kumari |
| p2_day* | Integer | P2's date of birth, eg: 24 |
| p2_month* | Integer | P2's month of birth, eg: 05 |
| p2_year* | Integer | P2's year of birth, eg: 1998 |
| p2_hour* | Integer | P2's hour, eg: 14 |
| p2_min* | Integer | P2's minute, eg: 40 |
| p2_sec* | Integer | P2's second, eg: 43 |
| p2_gender* | String | P2's gender, ex: male |
| p2_place* | String | P2's birth place, ex: New Delhi |
| p2_lat* | Float | P2's latitude, eg: 28.7041 |
| p2_lon* | Float | P2's longitude, eg: 77.1025 |
| p2_tzone* | Float | P2's timezone, eg: 5.5 Timezone List |
| lan | String | Language en/hi, default en |
| house_system | String | House system code, default — P (Placidus) |
200: OK Aspect Table Fetched Successfully
The following is a sample 200: OK JSON response structure for the Aspect Table API. It contains both p1_p2_aspect and p2_p1_aspect objects, detailing all planetary aspects between two individuals.
{
"success": 1,
"data": {
"p1_p2_aspect": {
"planetOne": "Rahul Kumar's planet",
"planetTwo": "Simran Kumari's planet",
"aspects": [
{
"planetOne": "Ascendant",
"planetTwo": "Ascendant",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Ascendant",
"planetTwo": "Neptune",
"orb": 3.71,
"aspect": "Trine",
"aspect_type": "Easy"
},
{
"planetOne": "Ascendant",
"planetTwo": "Pluto",
"orb": 1.03,
"aspect": "Sextile",
"aspect_type": "Mildly Easy"
},
{
"planetOne": "Sun",
"planetTwo": "Ascendant",
"orb": 2.76,
"aspect": "Trine",
"aspect_type": "Easy"
},
{
"planetOne": "Sun",
"planetTwo": "Sun",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Sun",
"planetTwo": "Mars",
"orb": 2.85,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Sun",
"planetTwo": "North node",
"orb": 3.12,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "Sun",
"planetTwo": "Pluto",
"orb": 3.79,
"aspect": "Opposition",
"aspect_type": "Hard"
},
{
"planetOne": "Moon",
"planetTwo": "Moon",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Moon",
"planetTwo": "Mercury",
"orb": 1.72,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Moon",
"planetTwo": "North node",
"orb": 6.97,
"aspect": "Trine",
"aspect_type": "Easy"
},
{
"planetOne": "Moon",
"planetTwo": "MC",
"orb": 7.09,
"aspect": "Sextile",
"aspect_type": "Mildly Easy"
},
{
"planetOne": "Moon",
"planetTwo": "Chiron",
"orb": 1.18,
"aspect": "Opposition",
"aspect_type": "Hard"
},
{
"planetOne": "Mars",
"planetTwo": "Ascendant",
"orb": 5.6,
"aspect": "Trine",
"aspect_type": "Easy"
},
{
"planetOne": "Mars",
"planetTwo": "Sun",
"orb": 2.85,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Mars",
"planetTwo": "Mars",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Mars",
"planetTwo": "North node",
"orb": 5.97,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "Mercury",
"planetTwo": "Moon",
"orb": 1.72,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Mercury",
"planetTwo": "Mercury",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Mercury",
"planetTwo": "Chiron",
"orb": 0.53,
"aspect": "Opposition",
"aspect_type": "Hard"
},
{
"planetOne": "Venus",
"planetTwo": "Venus",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Venus",
"planetTwo": "Saturn",
"orb": 4.82,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Jupiter",
"planetTwo": "Jupiter",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Saturn",
"planetTwo": "Venus",
"orb": 4.82,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Saturn",
"planetTwo": "Saturn",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "North node",
"planetTwo": "Pluto",
"orb": 0.67,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "South node",
"planetTwo": "Sun",
"orb": 3.12,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "South node",
"planetTwo": "Moon",
"orb": 6.97,
"aspect": "Sextile",
"aspect_type": "Mildly Easy"
},
{
"planetOne": "South node",
"planetTwo": "Mars",
"orb": 5.97,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "South node",
"planetTwo": "MC",
"orb": 0.12,
"aspect": "Trine",
"aspect_type": "Easy"
},
{
"planetOne": "Uranus",
"planetTwo": "Moon",
"orb": 0.38,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "Uranus",
"planetTwo": "Mercury",
"orb": 2.09,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "Uranus",
"planetTwo": "Uranus",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Neptune",
"planetTwo": "Sun",
"orb": 0.95,
"aspect": "Trine",
"aspect_type": "Easy"
},
{
"planetOne": "Neptune",
"planetTwo": "Mars",
"orb": 1.9,
"aspect": "Trine",
"aspect_type": "Easy"
},
{
"planetOne": "Neptune",
"planetTwo": "Neptune",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Pluto",
"planetTwo": "Sun",
"orb": 3.79,
"aspect": "Opposition",
"aspect_type": "Hard"
},
{
"planetOne": "Pluto",
"planetTwo": "South node",
"orb": 0.67,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "Pluto",
"planetTwo": "Pluto",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "MC",
"planetTwo": "Ascendant",
"orb": 0.25,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "MC",
"planetTwo": "North node",
"orb": 0.12,
"aspect": "Sextile",
"aspect_type": "Mildly Easy"
},
{
"planetOne": "MC",
"planetTwo": "MC",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Chiron",
"planetTwo": "Moon",
"orb": 1.18,
"aspect": "Opposition",
"aspect_type": "Hard"
},
{
"planetOne": "Chiron",
"planetTwo": "Mercury",
"orb": 0.53,
"aspect": "Opposition",
"aspect_type": "Hard"
},
{
"planetOne": "Chiron",
"planetTwo": "Uranus",
"orb": 1.56,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "Chiron",
"planetTwo": "Chiron",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
}
]
},
"p2_p1_aspect": {
"planetOne": "Simran Kumari's planet",
"planetTwo": "Rahul Kumar's planet",
"aspects": [
{
"planetOne": "Ascendant",
"planetTwo": "Ascendant",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Ascendant",
"planetTwo": "Neptune",
"orb": 3.71,
"aspect": "Trine",
"aspect_type": "Easy"
},
{
"planetOne": "Ascendant",
"planetTwo": "Pluto",
"orb": 1.03,
"aspect": "Sextile",
"aspect_type": "Mildly Easy"
},
{
"planetOne": "Sun",
"planetTwo": "Ascendant",
"orb": 2.76,
"aspect": "Trine",
"aspect_type": "Easy"
},
{
"planetOne": "Sun",
"planetTwo": "Sun",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Sun",
"planetTwo": "Mars",
"orb": 2.85,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Sun",
"planetTwo": "North node",
"orb": 3.12,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "Sun",
"planetTwo": "Pluto",
"orb": 3.79,
"aspect": "Opposition",
"aspect_type": "Hard"
},
{
"planetOne": "Moon",
"planetTwo": "Moon",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Moon",
"planetTwo": "Mercury",
"orb": 1.72,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Moon",
"planetTwo": "North node",
"orb": 6.97,
"aspect": "Trine",
"aspect_type": "Easy"
},
{
"planetOne": "Moon",
"planetTwo": "MC",
"orb": 7.09,
"aspect": "Sextile",
"aspect_type": "Mildly Easy"
},
{
"planetOne": "Moon",
"planetTwo": "Chiron",
"orb": 1.18,
"aspect": "Opposition",
"aspect_type": "Hard"
},
{
"planetOne": "Mars",
"planetTwo": "Ascendant",
"orb": 5.6,
"aspect": "Trine",
"aspect_type": "Easy"
},
{
"planetOne": "Mars",
"planetTwo": "Sun",
"orb": 2.85,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Mars",
"planetTwo": "Mars",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Mars",
"planetTwo": "North node",
"orb": 5.97,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "Mercury",
"planetTwo": "Moon",
"orb": 1.72,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Mercury",
"planetTwo": "Mercury",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Mercury",
"planetTwo": "Chiron",
"orb": 0.53,
"aspect": "Opposition",
"aspect_type": "Hard"
},
{
"planetOne": "Venus",
"planetTwo": "Venus",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Venus",
"planetTwo": "Saturn",
"orb": 4.82,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Jupiter",
"planetTwo": "Jupiter",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Saturn",
"planetTwo": "Venus",
"orb": 4.82,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Saturn",
"planetTwo": "Saturn",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "North node",
"planetTwo": "Pluto",
"orb": 0.67,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "South node",
"planetTwo": "Sun",
"orb": 3.12,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "South node",
"planetTwo": "Moon",
"orb": 6.97,
"aspect": "Sextile",
"aspect_type": "Mildly Easy"
},
{
"planetOne": "South node",
"planetTwo": "Mars",
"orb": 5.97,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "South node",
"planetTwo": "MC",
"orb": 0.12,
"aspect": "Trine",
"aspect_type": "Easy"
},
{
"planetOne": "Uranus",
"planetTwo": "Moon",
"orb": 0.38,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "Uranus",
"planetTwo": "Mercury",
"orb": 2.09,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "Uranus",
"planetTwo": "Uranus",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Neptune",
"planetTwo": "Sun",
"orb": 0.95,
"aspect": "Trine",
"aspect_type": "Easy"
},
{
"planetOne": "Neptune",
"planetTwo": "Mars",
"orb": 1.9,
"aspect": "Trine",
"aspect_type": "Easy"
},
{
"planetOne": "Neptune",
"planetTwo": "Neptune",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Pluto",
"planetTwo": "Sun",
"orb": 3.79,
"aspect": "Opposition",
"aspect_type": "Hard"
},
{
"planetOne": "Pluto",
"planetTwo": "South node",
"orb": 0.67,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "Pluto",
"planetTwo": "Pluto",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "MC",
"planetTwo": "Ascendant",
"orb": 0.25,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "MC",
"planetTwo": "North node",
"orb": 0.12,
"aspect": "Sextile",
"aspect_type": "Mildly Easy"
},
{
"planetOne": "MC",
"planetTwo": "MC",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
},
{
"planetOne": "Chiron",
"planetTwo": "Moon",
"orb": 1.18,
"aspect": "Opposition",
"aspect_type": "Hard"
},
{
"planetOne": "Chiron",
"planetTwo": "Mercury",
"orb": 0.53,
"aspect": "Opposition",
"aspect_type": "Hard"
},
{
"planetOne": "Chiron",
"planetTwo": "Uranus",
"orb": 1.56,
"aspect": "Square",
"aspect_type": "Hard"
},
{
"planetOne": "Chiron",
"planetTwo": "Chiron",
"orb": 0,
"aspect": "Conjunction",
"aspect_type": "Intense"
}
]
}
}
}
Example Code Implementations
Below are example implementations in various programming environments.
cURL
curl --location 'https://astroapi-4.divineapi.com/western-api/v1/synastry/aspect' \
--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/aspect',
'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/aspect",
"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/aspect"
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)
Notes
Ensure latitude and longitude are in decimal degrees (WGS84).
Timezone (p1_tzone, p2_tzone) is numeric offset from UTC; e.g., 5.5 for India.
If house_system is not specified, default is P (Placidus).
Language defaults to English (lan=en) if not provided.
Validate date and time inputs before sending requests.
Response includes both directional aspect sets (p1_p2_aspect and p2_p1_aspect).