search

Copy page

Copy page as Markdown for LLMs

View as Markdown

View this page as plain text


Open in ChatGPT

Ask ChatGPT about this page

Open in Claude

Ask Claude about this page

General Sign Report

Discover the essence of your astrological identity with the General Sign Report API, providing personalized insights into a planet’s sign placement (Sun, Moon, Mercury, etc.) and its attributes within the Western/Natal astrology flow.


Planet Allowed

These are the only accepted values for the :planet path parameter in the endpoint.

Planet ValueDescription
sunFor Sun data
moonFor Moon data
marsFor Mars data
mercuryFor Mercury data
venusFor Venus data
jupiterFor Jupiter data
saturnFor Saturn data
northnodeFor North Node data
southnodeFor South Node data
uranusFor Uranus data
neptuneFor Neptune data
plutoFor Pluto data
mcFor MC (Midheaven) data
chironFor Chiron data

Step by Step General Sign Report API Postman Testing Integration

https://support.divineapi.com/western-astrology-apis/testing-western-api-general-sign-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

CodeLanguage
enEnglish
hiHindi
ptPortuguese
frFrench
deGerman
jaJapanese
trTurkish
ruRussian
itItalian
esSpanish
nlDutch
plPolish

Guide: These languages are supported by this API. You can use them by passing 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

CodeDescription
PPlacidus
KKoch
RRegiomontanus
CCampanus
AEqual
WEqual, whole sign
NWhole sign, Aries = 1st house
XAxial rotation system / Meridian houses
TPolich/Page ("topocentric")
MMorinus
OPorphyry
BAlcabitius
DEqual / MC
EEqual = A
FCarter poli-equatorial
G36 Gauquelin sectors
HHorizon / Azimuth
ISunshine
iSunshine alternative
LPullen
S-delta
QPullen
S-ratio
SSripati
UKrusinski-Pisa-Goelzer
VEqual Vehlow
YAPC houses

Note: The default house system used is P – Placidus.


API Endpoint

POST https://astroapi-4.divineapi.com/western-api/v2/general-sign-report/:planet

Replace :planet with one of the allowed planet values (for example: sun, moon, mercury, mc, chiron).

Returns General Sign Report in response.


Headers

NameTypeDescription
Authorization*StringYour API Access Token, e.g. Bearer {token}

Request Body

NameTypeDescription
api_key*StringYour API key
full_name*StringFull name, e.g. Rahul Kumar
day*IntegerDate of birth, e.g. 24
month*IntegerMonth of birth, e.g. 05
year*IntegerYear of birth, e.g. 2023
hour*IntegerHour, e.g. 14
min*IntegerMinute, e.g. 40
sec*IntegerSecond, e.g. 43
gender*StringGender, e.g. male
place*StringPlace, e.g. New Delhi
lat*FloatLatitude, e.g. 28.7041
lon*FloatLongitude, e.g. 77.1025
tzone*FloatTimezone, e.g. 5.5 (see Timezone List)
lanStringLanguage code, default: en
house_systemStringHouse system code, default: P (Placidus)

Example Response: 200 OK – General Sign Report Fetched Successfully

{
    "success": 1,
    "data": {
        "planet_name": "Sun",
        "sign_name": "Sagittarius",
        "report": [
            {
                "heading": "The Explorer’s Essence",
                "description": "With the Sun in Sagittarius, your core essence bursts with an unquenchable thirst for exploration and discovery. You are inexorably drawn to the distant horizons of both mind and map, embodying a spirited and ever-expanding identity."
            },
            {
                "heading": "Dream Chaser’s Emotions",
                "description": "Internally, you are fueled by an optimistic and adventurous spirit. Your emotions swirl around your dreams and philosophy, driving an eternal search for deeper meaning and higher truth in life."
            },
            {
                "heading": "Gifts of the Wanderlust Spirit",
                "description": "Your innate optimism and enthusiasm serve as powerful catalysts that inspire and influence those around you. These strengths forge connections and open doors, as your genuine quest for knowledge makes you a lifelong learner and sharer of wisdom."
            },
            {
                "heading": "Navigating the Flight of Fancy",
                "description": "The challenge for such a free spirit lies in grounding your abundant ideas and maintaining focus. You might struggle with impatience or a tendency to overlook details. Embracing patience and practicality will enrich your journey."
            },
            {
                "heading": "Mission of the Global Pathfinder",
                "description": "Your life themes revolve around expanding horizons, both literally and intellectually. Your mission is to seek and spread knowledge, understanding different cultures, and weaving the tapestry of human experience into a richer whole."
            }
        ]
    }
}

Example Code Implementations

Below are example implementations in various programming environments.


cURL

curl --location 'https://astroapi-4.divineapi.com/western-api/v2/general-sign-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"'
--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-sign-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("house_system", "P");

var settings = {
  "url": "https://astroapi-4.divineapi.com/western-api/v2/general-sign-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-sign-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)