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 Value	Description
sun	For Sun data
moon	For Moon data
mars	For Mars data
mercury	For Mercury data
venus	For Venus data
jupiter	For Jupiter data
saturn	For Saturn data
northnode	For North Node data
southnode	For South Node data
uranus	For Uranus data
neptune	For Neptune data
pluto	For Pluto data
mc	For MC (Midheaven) data
chiron	For 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

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 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

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-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

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 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)

curl -X POST "https://astroapi-4.divineapi.com/western-api/v2/general-sign-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-sign-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-sign-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-sign-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-sign-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-sign-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-sign-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-sign-report/sun", content); var result = await response.Content.ReadAsStringAsync(); Console.WriteLine(result); } }