House Cusps

Get accurate house cusps data for natal astrology with Divine API. Essential for analyzing astrological charts and understanding personal life aspects.

Delve into the beginnings of each astrological house with House Cusps, revealing the foundational aspects of your life sectors.

Step by Step House Cusps API Postman Testing Integration

Supported Language Codes:

Support Article URL - https://support.divineapi.com/general-api-support/translating-a-natal-apis-into-a-different-language

en For English

hi For Hindi

pt For Portuguese

fr For French

de For German

ja For Japanese

tr For turkish

ru For Russian

it For Italian

es For Spanish

nl For Dutch

pl For Polish

Guide: These languages are supported by this API. You can use by passing "lan" in body with a 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

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

POST https://astroapi-4.divineapi.com/western-api/v1/house-cusps

Returns House Cusps in response

Headers

Name	Type	Description
Authorization*	String	your API Access Token eg: Bearer {token}

Request Body

Name	Type	Description
api_key*	String	your API key
full_name*	String	full name, ex: Rahul Kumar
day*	Integer	date of birth, eg: 24
month*	Integer	month of birth, eg: 05
year*	Integer	year of birth, eg: 2023
hour*	Integer	hour, eg: 14
min *	Integer	minute, eg: 40
sec*	Integer	second, eg 43
gender*	String	gender, ex: male
place*	String	place, ex: New Delhi
lat*	Float	latitude, eg: 28.7041
lon*	Float	longitude, eg: 77.1025
tzone*	Float	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

{
    "success": 1,
    "data": {
        "houses": [
            {
                "house": 1,
                "full_degree": "185.7194444",
                "sign": "Libra",
                "sign_no": 7,
                "longitude": "5:43:10"
            },
            {
                "house": 2,
                "full_degree": "213.9628614",
                "sign": "Scorpio",
                "sign_no": 8,
                "longitude": "3:57:46"
            },
            {
                "house": 3,
                "full_degree": "244.4180999",
                "sign": "Sagittarius",
                "sign_no": 9,
                "longitude": "4:25:5"
            },
            {
                "house": 4,
                "full_degree": "275.9631371",
                "sign": "Capricorn",
                "sign_no": 10,
                "longitude": "5:57:47"
            },
            {
                "house": 5,
                "full_degree": "307.5798168",
                "sign": "Aquarius",
                "sign_no": 11,
                "longitude": "7:34:47"
            },
            {
                "house": 6,
                "full_degree": "337.9903129",
                "sign": "Pisces",
                "sign_no": 12,
                "longitude": "7:59:25"
            },
            {
                "house": 7,
                "full_degree": "5.7194444",
                "sign": "Aries",
                "sign_no": 1,
                "longitude": "5:43:10"
            },
            {
                "house": 8,
                "full_degree": "33.9628614",
                "sign": "Taurus",
                "sign_no": 2,
                "longitude": "3:57:46"
            },
            {
                "house": 9,
                "full_degree": "64.4180999",
                "sign": "Gemini",
                "sign_no": 3,
                "longitude": "4:25:5"
            },
            {
                "house": 10,
                "full_degree": "95.9631371",
                "sign": "Cancer",
                "sign_no": 4,
                "longitude": "5:57:47"
            },
            {
                "house": 11,
                "full_degree": "127.5798168",
                "sign": "Leo",
                "sign_no": 5,
                "longitude": "7:34:47"
            },
            {
                "house": 12,
                "full_degree": "157.9903129",
                "sign": "Virgo",
                "sign_no": 6,
                "longitude": "7:59:25"
            }
        ],
        "ascendant": "185.7194444",
        "midheaven": "95.9631371",
        "vertex": "31.4159578"
    }
}

Take a look at how you might call this method via cURL, NodeJS or JavaScript jQuery AJAX and Python :

cURL

curl --location 'https://astroapi-4.divineapi.com/western-api/v1/house-cusps' \
--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, India"' \
--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-4.divineapi.com/western-api/v1/house-cusps',
  '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, India',
    'lat': '28.7041',
    'lon': '77.1025',
    'tzone': '5.5'
    'lan': 'en',
    'house_system': 'P'
  }
};
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, India");
form.append("lat", "28.7041");
form.append("lon", "77.1025");
form.append("tzone", "5.5");
form.append("lan", "en");
form.append("house_system", "P");

var settings = {
  "url": "https://astroapi-4.divineapi.com/western-api/v1/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-4.divineapi.com/western-api/v1/house-cusps"

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, India',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5'
'lan': 'en',
'house_system': 'P'}

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

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

print(response.text)