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

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

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

Request Body

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)