General House Report

Discover the essence of your astrological identity with the General House Report API, delivering personalized insights based on which house a particular planet occupies in the natal chart. This endpoint is part of the Western Astrology flow and is useful for presenting house-wise narrative reports to users.

Step by Step General House Report API Postman Testing Integration

https://support.divineapi.com/western-astrology-apis/testing-western-api-general-house-report-api-using-postman

Supported Language Codes

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. Pass lan in the request body with the corresponding language code.

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	House System Name
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/v2/general-house-report/:planet

Replace :planet with the planet whose house-based report you want to fetch (for example: sun, moon, mercury, etc.), as per your implementation.

Returns General House Report in response.

Headers

Name	Type	Description
Authorization*	String	Your API Access Token, e.g. `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, e.g. 14
min*	Integer	Minute, e.g. 40
sec*	Integer	Second, e.g. 43
gender*	String	Gender, e.g. male
place*	String	Place, 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 (see 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 General House Report Fetched Successfully

{
    "success": 1,
    "data": {
        "planet_name": "Sun",
        "house": 7,
        "report": [
            {
                "heading": "Beacon of Connection",
                "description": "With the Sun resting in the seventh house, your personality shines brightest in the dance of relationships. You exude a magnetism that draws people into your orbit, positioning you as a charismatic and pivotal figure in any partnership."
            },
            {
                "heading": "Heartbeat of Harmony",
                "description": "Your emotional landscape seeks equilibrium and appreciation in close bonds. There is a profound wish for recognition from those you care about, reinforcing your need for balanced and respectful interactions."
            },
            {
                "heading": "Champion of Equitable Alliances",
                "description": "Your innate leadership skills bloom in settings that require partnership. Assertive yet fair, you excel in situations where cooperation and equal input are valued, making you an exemplary collaborator."
            },
            {
                "heading": "Navigating the Reflections of Self",
                "description": "The drive for a harmonious partnership may sometimes overshadow your personal growth. Challenges arise in maintaining your identity without compromising too much for the sake of peace. Cultivating self-awareness alongside togetherness can enhance your relational dynamics."
            },
            {
                "heading": "Commitment to Collective Success",
                "description": "Your journey emphasizes meaningful connections. It's built on forming and nurturing relationships equitably. Whether in love or business, your success often shines through forged alliances and shared victories."
            }
        ]
    }
}

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-4.divineapi.com/western-api/v2/general-house-report/sun' \
--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"' \
--form 'house_system="P"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-4.divineapi.com/western-api/v2/general-house-report/sun',
  '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/v2/general-house-report/sun",
  "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/v2/general-house-report/sun"

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)

curl -X POST "https://astroapi-4.divineapi.com/western-api/v2/general-house-report/sun" \ -H "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"' \ --form 'house_system="P"'

import requests url = "https://astroapi-4.divineapi.com/western-api/v2/general-house-report/sun" headers = { "Authorization": "Bearer {Your Auth Token}", } 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", } response = requests.post(url, headers=headers, data=payload) print(response.json())

<?php use GuzzleHttp\Client; $client = new Client(); $response = $client->request('POST', 'https://astroapi-4.divineapi.com/western-api/v2/general-house-report/sun', [ 'headers' => [ 'Authorization' => 'Bearer {Your Auth Token}', ], 'multipart' => [ ['name' => 'api_key', 'contents' => '{Your API Key}'], ['name' => 'full_name', 'contents' => 'Rahul Kumar'], ['name' => 'day', 'contents' => '24'], ['name' => 'month', 'contents' => '05'], ['name' => 'year', 'contents' => '2023'], ['name' => 'hour', 'contents' => '14'], ['name' => 'min', 'contents' => '40'], ['name' => 'sec', 'contents' => '43'], ['name' => 'gender', 'contents' => 'male'], ['name' => 'place', 'contents' => 'New Delhi, India'], ['name' => 'lat', 'contents' => '28.7041'], ['name' => 'lon', 'contents' => '77.1025'], ['name' => 'tzone', 'contents' => '5.5'], ['name' => 'lan', 'contents' => 'en'], ['name' => 'house_system', 'contents' => 'P'], ], ]); echo $response->getBody();

package main import ( "bytes" "fmt" "mime/multipart" "net/http" "io" ) func main() { body := &bytes.Buffer{} writer := multipart.NewWriter(body) writer.WriteField("api_key", "{Your API Key}") writer.WriteField("full_name", "Rahul Kumar") writer.WriteField("day", "24") writer.WriteField("month", "05") writer.WriteField("year", "2023") writer.WriteField("hour", "14") writer.WriteField("min", "40") writer.WriteField("sec", "43") writer.WriteField("gender", "male") writer.WriteField("place", "New Delhi, India") writer.WriteField("lat", "28.7041") writer.WriteField("lon", "77.1025") writer.WriteField("tzone", "5.5") writer.WriteField("lan", "en") writer.WriteField("house_system", "P") writer.Close() req, _ := http.NewRequest("POST", "https://astroapi-4.divineapi.com/western-api/v2/general-house-report/sun", body) req.Header.Set("Content-Type", writer.FormDataContentType()) req.Header.Set("Authorization", "Bearer {Your Auth Token}") client := &http.Client{} resp, _ := client.Do(req) defer resp.Body.Close() body2, _ := io.ReadAll(resp.Body) fmt.Println(string(body2)) }

import okhttp3.*; import java.io.IOException; public class Main { public static void main(String[] args) throws IOException { OkHttpClient client = new OkHttpClient(); RequestBody body = new MultipartBody.Builder() .setType(MultipartBody.FORM) .addFormDataPart("api_key", "{Your API Key}") .addFormDataPart("full_name", "Rahul Kumar") .addFormDataPart("day", "24") .addFormDataPart("month", "05") .addFormDataPart("year", "2023") .addFormDataPart("hour", "14") .addFormDataPart("min", "40") .addFormDataPart("sec", "43") .addFormDataPart("gender", "male") .addFormDataPart("place", "New Delhi, India") .addFormDataPart("lat", "28.7041") .addFormDataPart("lon", "77.1025") .addFormDataPart("tzone", "5.5") .addFormDataPart("lan", "en") .addFormDataPart("house_system", "P") .build(); Request request = new Request.Builder() .url("https://astroapi-4.divineapi.com/western-api/v2/general-house-report/sun") .post(body) .addHeader("Authorization", "Bearer {Your Auth Token}") .build(); Response response = client.newCall(request).execute(); System.out.println(response.body().string()); } }

import Foundation let url = URL(string: "https://astroapi-4.divineapi.com/western-api/v2/general-house-report/sun")! var request = URLRequest(url: url) request.httpMethod = "POST" request.setValue("Bearer {Your Auth Token}", forHTTPHeaderField: "Authorization") let boundary = "Boundary-\(UUID().uuidString)" request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type") var bodyData = Data() bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"api_key\"\r\n\r\n".data(using: .utf8)!) bodyData.append("{Your API Key}\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"full_name\"\r\n\r\n".data(using: .utf8)!) bodyData.append("Rahul Kumar\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"day\"\r\n\r\n".data(using: .utf8)!) bodyData.append("24\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"month\"\r\n\r\n".data(using: .utf8)!) bodyData.append("05\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"year\"\r\n\r\n".data(using: .utf8)!) bodyData.append("2023\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"hour\"\r\n\r\n".data(using: .utf8)!) bodyData.append("14\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"min\"\r\n\r\n".data(using: .utf8)!) bodyData.append("40\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"sec\"\r\n\r\n".data(using: .utf8)!) bodyData.append("43\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"gender\"\r\n\r\n".data(using: .utf8)!) bodyData.append("male\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"place\"\r\n\r\n".data(using: .utf8)!) bodyData.append("New Delhi, India\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"lat\"\r\n\r\n".data(using: .utf8)!) bodyData.append("28.7041\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"lon\"\r\n\r\n".data(using: .utf8)!) bodyData.append("77.1025\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"tzone\"\r\n\r\n".data(using: .utf8)!) bodyData.append("5.5\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"lan\"\r\n\r\n".data(using: .utf8)!) bodyData.append("en\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)\r\n".data(using: .utf8)!) bodyData.append("Content-Disposition: form-data; name=\"house_system\"\r\n\r\n".data(using: .utf8)!) bodyData.append("P\r\n".data(using: .utf8)!) bodyData.append("--\(boundary)--\r\n".data(using: .utf8)!) request.httpBody = bodyData let task = URLSession.shared.dataTask(with: request) { data, response, error in if let data = data { print(String(data: data, encoding: .utf8) ?? "") } } task.resume()

import okhttp3.* fun main() { val client = OkHttpClient() val body = MultipartBody.Builder() .setType(MultipartBody.FORM) .addFormDataPart("api_key", "{Your API Key}") .addFormDataPart("full_name", "Rahul Kumar") .addFormDataPart("day", "24") .addFormDataPart("month", "05") .addFormDataPart("year", "2023") .addFormDataPart("hour", "14") .addFormDataPart("min", "40") .addFormDataPart("sec", "43") .addFormDataPart("gender", "male") .addFormDataPart("place", "New Delhi, India") .addFormDataPart("lat", "28.7041") .addFormDataPart("lon", "77.1025") .addFormDataPart("tzone", "5.5") .addFormDataPart("lan", "en") .addFormDataPart("house_system", "P") .build() val request = Request.Builder() .url("https://astroapi-4.divineapi.com/western-api/v2/general-house-report/sun") .post(body!!) .addHeader("Authorization", "Bearer {Your Auth Token}") .build() client.newCall(request).execute().use { response -> println(response.body?.string()) } }

using System; using System.Net.Http; using System.Threading.Tasks; class Program { static async Task Main() { using var client = new HttpClient(); client.DefaultRequestHeaders.Add("Authorization", "Bearer {Your Auth Token}"); var content = new MultipartFormDataContent(); content.Add(new StringContent("{Your API Key}"), "api_key"); content.Add(new StringContent("Rahul Kumar"), "full_name"); content.Add(new StringContent("24"), "day"); content.Add(new StringContent("05"), "month"); content.Add(new StringContent("2023"), "year"); content.Add(new StringContent("14"), "hour"); content.Add(new StringContent("40"), "min"); content.Add(new StringContent("43"), "sec"); content.Add(new StringContent("male"), "gender"); content.Add(new StringContent("New Delhi, India"), "place"); content.Add(new StringContent("28.7041"), "lat"); content.Add(new StringContent("77.1025"), "lon"); content.Add(new StringContent("5.5"), "tzone"); content.Add(new StringContent("en"), "lan"); content.Add(new StringContent("P"), "house_system"); var response = await client.PostAsync("https://astroapi-4.divineapi.com/western-api/v2/general-house-report/sun", content); var result = await response.Content.ReadAsStringAsync(); Console.WriteLine(result); } }