Dominants

The Dominants API identifies the most influential planets, dominant element balance, and the signature sign pattern from a natal chart useful for personality profiling, chart emphasis, and quick “top factors” summaries in Western astrology.

API Endpoint

POST https://astroapi-8.divineapi.com/western-api/v1/dominants

Headers

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

Request Body

Name	Type	Description (with example)
api_key*	String	Your API key (e.g., `Your API Key`)
full_name*	String	Full name of the user (e.g., `Rahul Kumar`)
day*	Integer	Birth day (e.g., `24`)
month*	Integer	Birth month (e.g., `05`)
year*	Integer	Birth year (e.g., `2023`)
hour*	Integer	Birth hour in 24-hour format (e.g., `14`)
min*	Integer	Birth minutes (e.g., `40`)
sec*	Integer	Birth seconds (e.g., `43`)
gender	String	Gender of the user (e.g., `male`)
place*	String	Birth place (e.g., `New Delhi, India`)
lat*	Float	Birth latitude (e.g., `28.7041`)
lon*	Float	Birth longitude (e.g., `77.1025`)
tzone*	Float	Timezone in decimal (e.g., `5.5`)
method*	String	Dominants calculation method (e.g., `TRADITIONAL`) Allowed Values: TRADITIONAL, MODERN

200: OK Dominants Details fetched successfully

{
    "status": "success",
    "code": 200,
    "message": "Request successful",
    "data": {
        "dominant_planets": [
            {
                "planet_name": "Sun",
                "sign": 3,
                "house": 0,
                "angle": 0,
                "ruler": 1,
                "aspects": 7,
                "total": 11,
                "percent": "14.29",
                "rank": 3
            },
            {
                "planet_name": "Moon",
                "sign": 6,
                "house": 2,
                "angle": 0,
                "ruler": 3,
                "aspects": 6,
                "total": 17,
                "percent": "22.08",
                "rank": 1
            },
            {
                "planet_name": "Mercury",
                "sign": 4,
                "house": 0,
                "angle": 0,
                "ruler": 1,
                "aspects": 3,
                "total": 8,
                "percent": "10.39",
                "rank": 7
            },
            {
                "planet_name": "Venus",
                "sign": 2,
                "house": 2,
                "angle": 0,
                "ruler": 5,
                "aspects": 0,
                "total": 9,
                "percent": "11.69",
                "rank": 6
            },
            {
                "planet_name": "Mars",
                "sign": 4,
                "house": 2,
                "angle": 0,
                "ruler": 0,
                "aspects": 6,
                "total": 12,
                "percent": "15.58",
                "rank": 2
            },
            {
                "planet_name": "Jupiter",
                "sign": 2,
                "house": 2,
                "angle": 0,
                "ruler": 1,
                "aspects": 5,
                "total": 10,
                "percent": "12.99",
                "rank": 4
            },
            {
                "planet_name": "Saturn",
                "sign": 3,
                "house": 0,
                "angle": 0,
                "ruler": 0,
                "aspects": 7,
                "total": 10,
                "percent": "12.99",
                "rank": 5
            }
        ],
        "dominant_element": {
            "table": {
                "Fire": {
                    "sun_moon_asc": 0,
                    "personal": 2,
                    "dominant": 2,
                    "sum": 4,
                    "percent": "16%"
                },
                "Earth": {
                    "sun_moon_asc": 0,
                    "personal": 4,
                    "dominant": 0,
                    "sum": 4,
                    "percent": "16%"
                },
                "Air": {
                    "sun_moon_asc": 6,
                    "personal": 0,
                    "dominant": 2,
                    "sum": 8,
                    "percent": "32%"
                },
                "Water": {
                    "sun_moon_asc": 3,
                    "personal": 4,
                    "dominant": 2,
                    "sum": 9,
                    "percent": "36%"
                }
            },
            "dominant": "Water"
        },
        "signature_sign": {
            "element_counts": {
                "Fire": 1,
                "Earth": 2,
                "Air": 1,
                "Water": 3
            },
            "modality_counts": {
                "Cardinal": 2,
                "Fixed": 3,
                "Mutable": 2
            },
            "signature": "Water + Fixed",
            "sign": "Scorpio"
        }
    }
}

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-8.divineapi.com/western-api/v1/dominants' \
--header 'Authorization: Bearer {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 'method="TRADITIONAL"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-8.divineapi.com/western-api/v1/dominants',
  'headers': {
    'Authorization': 'Bearer {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',
    'method': 'TRADITIONAL'
  }
};
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("method", "TRADITIONAL");

var settings = {
  "url": "https://astroapi-8.divineapi.com/western-api/v1/dominants",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer {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-8.divineapi.com/western-api/v1/dominants"

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',
'method': 'TRADITIONAL'}
files=[

]
headers = {
  'Authorization': 'Bearer {token}'
}

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

print(response.text)

Implementation Notes

Use Authorization: Bearer {Your Auth Token} and {Your API Key} securely; never expose them in client-side code.

Provide date, time, and coordinates in correct numeric formats; use decimal timezone values (e.g., 5.5).

Check HTTP status codes, log responses, and handle 4xx/5xx errors gracefully.