Divine API
Copy page
Copy page as Markdown for LLMs
House Cusps
Explore the Composite House Cusps API, which provides detailed information about the house cusps for two individuals’ composite charts. This API helps in understanding the combined astrological influence and house structure formed when two natal charts are merged, offering insights into relationship dynamics and shared life patterns.
Step by Step Planetary Positions API Postman Testing Integration
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 by passing "lan" in body with a value of the language.
Endpoint
POST https://astroapi-8.divineapi.com/western-api/v1/composite/house-cusps
Returns House Cusps in response.
Headers
| Name | Type | Description |
|---|---|---|
| Authorization* | String | Your API Access Tokeneg: 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_lon* | Float | P2's longitude, eg: 77.1025 |
| p2_lat* | Float | P2's latitude, eg: 28.7041 |
| 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 House Cusps fetched successfully
{
"status": "success",
"code": 200,
"message": "Request successful",
"data": {
"p1": {
"houses": [
{
"house": 1,
"full_degree": "185.767239",
"sign": "Libra",
"sign_no": 7,
"longitude": "5:46:2"
},
{
"house": 2,
"full_degree": "214.0124023",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "4:0:45"
},
{
"house": 3,
"full_degree": "244.4678097",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "4:28:4"
},
{
"house": 4,
"full_degree": "276.0131067",
"sign": "Capricorn",
"sign_no": 10,
"longitude": "6:0:47"
},
{
"house": 5,
"full_degree": "307.6305571",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "7:37:50"
},
{
"house": 6,
"full_degree": "338.0406884",
"sign": "Pisces",
"sign_no": 12,
"longitude": "8:2:26"
},
{
"house": 7,
"full_degree": "5.767239",
"sign": "Aries",
"sign_no": 1,
"longitude": "5:46:2"
},
{
"house": 8,
"full_degree": "34.0124023",
"sign": "Taurus",
"sign_no": 2,
"longitude": "4:0:45"
},
{
"house": 9,
"full_degree": "64.4678097",
"sign": "Gemini",
"sign_no": 3,
"longitude": "4:28:4"
},
{
"house": 10,
"full_degree": "96.0131067",
"sign": "Cancer",
"sign_no": 4,
"longitude": "6:0:47"
},
{
"house": 11,
"full_degree": "127.6305571",
"sign": "Leo",
"sign_no": 5,
"longitude": "7:37:50"
},
{
"house": 12,
"full_degree": "158.0406884",
"sign": "Virgo",
"sign_no": 6,
"longitude": "8:2:26"
}
],
"ascendant": "185.767239",
"midheaven": "96.0131067",
"vertex": "31.6351367"
},
"p2": {
"houses": [
{
"house": 1,
"full_degree": "110.7290016",
"sign": "Cancer",
"sign_no": 4,
"longitude": "20:43:44"
},
{
"house": 2,
"full_degree": "133.593219",
"sign": "Leo",
"sign_no": 5,
"longitude": "13:35:36"
},
{
"house": 3,
"full_degree": "159.6440143",
"sign": "Virgo",
"sign_no": 6,
"longitude": "9:38:38"
},
{
"house": 4,
"full_degree": "190.5951484",
"sign": "Libra",
"sign_no": 7,
"longitude": "10:35:43"
},
{
"house": 5,
"full_degree": "225.2991626",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "15:17:57"
},
{
"house": 6,
"full_degree": "259.6229902",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "19:37:23"
},
{
"house": 7,
"full_degree": "290.7290016",
"sign": "Capricorn",
"sign_no": 10,
"longitude": "20:43:44"
},
{
"house": 8,
"full_degree": "313.593219",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "13:35:36"
},
{
"house": 9,
"full_degree": "339.6440143",
"sign": "Pisces",
"sign_no": 12,
"longitude": "9:38:38"
},
{
"house": 10,
"full_degree": "10.5951484",
"sign": "Aries",
"sign_no": 1,
"longitude": "10:35:43"
},
{
"house": 11,
"full_degree": "45.2991626",
"sign": "Taurus",
"sign_no": 2,
"longitude": "15:17:57"
},
{
"house": 12,
"full_degree": "79.6229902",
"sign": "Gemini",
"sign_no": 3,
"longitude": "19:37:23"
}
],
"ascendant": "110.7290016",
"midheaven": "10.5951484",
"vertex": "239.9060513"
},
"composite": {
"houses": [
{
"house": 1,
"full_degree": "148.2481203",
"sign": "Leo",
"sign_no": 5,
"longitude": "28:14:53"
},
{
"house": 2,
"full_degree": "173.8028106",
"sign": "Virgo",
"sign_no": 6,
"longitude": "23:48:10"
},
{
"house": 3,
"full_degree": "202.0559120",
"sign": "Libra",
"sign_no": 7,
"longitude": "22:03:21"
},
{
"house": 4,
"full_degree": "233.3041275",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "23:18:14"
},
{
"house": 5,
"full_degree": "266.4648598",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "26:27:53"
},
{
"house": 6,
"full_degree": "298.8318393",
"sign": "Capricorn",
"sign_no": 10,
"longitude": "28:49:54"
},
{
"house": 7,
"full_degree": "328.2481203",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "28:14:53"
},
{
"house": 8,
"full_degree": "353.8028106",
"sign": "Pisces",
"sign_no": 12,
"longitude": "23:48:10"
},
{
"house": 9,
"full_degree": "22.0559120",
"sign": "Aries",
"sign_no": 1,
"longitude": "22:03:21"
},
{
"house": 10,
"full_degree": "53.3041275",
"sign": "Taurus",
"sign_no": 2,
"longitude": "23:18:14"
},
{
"house": 11,
"full_degree": "86.4648599",
"sign": "Gemini",
"sign_no": 3,
"longitude": "26:27:53"
},
{
"house": 12,
"full_degree": "118.8318393",
"sign": "Cancer",
"sign_no": 4,
"longitude": "28:49:54"
}
],
"ascendant": "148.2481203",
"midheaven": "53.3041275",
"vertex": "315.7705940"
}
}
}
Example Code Implementations
Below are example implementations in various programming environments.
cURL
curl --location 'https://astroapi-8.divineapi.com/western-api/v1/composite/house-cusps' \
--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-8.divineapi.com/western-api/v1/composite/house-cusps',
'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-8.divineapi.com/western-api/v1/composite/house-cusps",
"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-8.divineapi.com/western-api/v1/composite/house-cusps"
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 Notes
Use Authorization: Bearer {Your Auth Token} and {Your API Key} securely; never expose them in client-side code.
Provide date, time, and coordinates in correct numeric formats; use decimal timezone values (e.g., 5.5).
Check HTTP status codes, log responses, and handle 4xx/5xx errors gracefully.
Defaults are lan=en and house_system=P; test via Postman first and always use HTTPS for secure communication.